Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Chapter 3 - Standard File Package / Standard File Package Reference

Standard File Package Routines / Saving Files

StandardPutFile
You can use the StandardPutFile procedure to display the default Save dialog box when the user is saving a file.
PROCEDURE StandardPutFile (prompt: Str255; defaultName: Str255;
                           VAR reply: StandardFileReply);
prompt
The prompt message to be displayed over the text field.
defaultName

The initial name of the file.
reply
The reply record, which StandardPutFile fills in before returning.

DESCRIPTION
The StandardPutFile procedure presents a dialog box through which the user specifies the name and location of a file to be written to. The dialog box is centered on the screen. While the dialog box is active, StandardPutFile gets and handles events until the user completes the interaction, either by selecting a name and authorizing the save or by canceling the save. The StandardPutFile procedure returns the user's input in a record of type StandardFileReply.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for StandardPutFile are
Trap macro Selector
_Pack3 $0005

SPECIAL CONSIDERATIONS
The StandardPutFile procedure is not available in all versions of system software. Use the Gestalt function to determine whether StandardPutFile is available before calling it.
Because StandardPutFile may move memory, you should not call it at interrupt time.