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

SFPutFile
Use the SFPutFile procedure to display the standard Save dialog box when the user is saving a file.
PROCEDURE SFPutFile (where: Point; prompt: Str255;
                     origName: Str255; dlgHook: DlgHookProcPtr;
                     VAR reply: SFReply);
where
The upper-left corner of the dialog box, in global coordinates.
prompt
The prompt message to be displayed over the text field.
origName
The initial name of the file.
dlgHook
A pointer to your dialog hook function, which handles item selections received from the Dialog Manager. Specify a value of NIL if you want
the standard items handled in the standard ways. See "Writing a Dialog Hook Function" on page 3-21 for a description of the dialog
hook function.
reply
The reply record, which SFPutFile fills in before returning.

DESCRIPTION
The SFPutFile procedure presents a dialog box through which the user specifies the name and location of a file to be written to. During the dialog, SFPutFile 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 SFPutFile procedure returns the user's input in a record of type SFReply.

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

SPECIAL CONSIDERATIONS
Because SFPutFile may move memory, you should not call it at interrupt time.