Legacy Document

Inside Macintosh: Files /

Chapter 3 - Standard File Package / Standard File Package Reference

Standard File Package Routines / Opening Files

StandardGetFile

You can use the StandardGetFile procedure to display the default Open dialog box when the user is opening a file.

PROCEDURE StandardGetFile (fileFilter: FileFilterProcPtr;
                           numTypes: Integer; 
                           typeList: SFTypeList; 
                           VAR reply: StandardFileReply);

fileFilter

A pointer to an optional file filter function, provided by your application, through which StandardGetFile passes files of the specified types.

numTypes

The number of file types to be displayed. If you specify a numTypes value of -1, the first filtering passes files of all types.

typeList

A list of file types to be displayed.

reply

The reply record, which StandardGetFile fills in before returning.

DESCRIPTION

The StandardGetFile procedure presents a dialog box through which the user specifies the name and location of a file to be opened. While the dialog box is active, StandardGetFile gets and handles events until the user completes the interaction, either by selecting a file to open or by canceling the operation. StandardGetFile returns the user's input in a record of type StandardFileReply.

The fileFilter, numTypes, and typeList parameters together determine which files appear in the displayed list. The first filtering is by file type, which you specify in the numTypes and typeList parameters. The numTypes parameter specifies the number of file types to be displayed. You can specify one or more types. If you specify a numTypes value of -1, the first filtering passes files of all types.

The fileFilter parameter points to an optional file filter function, provided by your application, through which StandardGetFile passes files of the specified types. See "Writing a File Filter Function" on page 3-20 for a description of the file filter function.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for StandardGetFile are

Trap macro	Selector
_Pack3	$0006

SPECIAL CONSIDERATIONS

The StandardGetFile procedure is not available in all versions of system software. Use the Gestalt function to determine whether StandardGetFile is available before calling it.

Because StandardGetFile may move memory, you should not call it at interrupt time.