Legacy Document

Inside Macintosh: Files /

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.