Legacy Document

Inside Macintosh: Apple Guide Complete / Part 3 - Integrating Guide Files

Chapter 9 - Apple Guide API / Getting Information About Guide Files

/

AGFileGetSelector

Use the AGFileGetSelector function to access a guide file's gestalt selector and its associated value.

OSErr AGFileGetSelector
                  (AGFileFSSpecType *fileSpec,
                   AGFileSelectorIndexType selectorNumber,
                   AGFileSelectorType *selector,
                   AGFileSelectorValueType *value);

fileSpec

A pointer to the file system specification record for the guide file.

selectorNumber

A selector index number. To access the first gestalt selector, specify 1; to access the second gestalt selector, specify 2; and to access the third gestalt selector, specify 3.

selector

The AGFileGetSelector function returns, through this parameter, a four-character value gestalt selector for the gestalt selector specified by the selectorNumber parameter.

value

The AGFileGetSelector function returns, through this parameter, a long integer associated with the gestalt selector returned in the selector parameter.

DESCRIPTION

The AGFileGetSelector function returns, in its selector and value parameters, the gestalt selector and its required value for the guide file specified in the fileSpec parameter. The gestalt selector and value correspond to those specified by a <Gestalt> command in the guide file's source files.

SEE ALSO

For a complete list of Gestalt selector codes, see the chapter "Gestalt Manager" in Inside Macintosh: Operating System Utilities.