![]() |
NavDialogOptions |
Header: Navigation.h |
The NavDialogOptionsstructure contains dialog box configuration settings you can pass to several Navigation Services functions.
struct NavDialogOptions { UInt16 version; NavDialogOptionFlags dialogOptionFlags; Point location; Str255 clientName; Str255 windowTitle; Str255 actionButtonLabel; Str255 cancelButtonLabel; Str255 savedFileName; Str255 message; UInt32 preferenceKey; NavMenuItemSpecArrayHandle popupExtension; char reserved[494]; };
Identifies the version of this structure. Be sure to specify the kNavDialogOptionsVersion constant in this field.
One of several constants defined by the NavDialogOptionFlags data type as described in
The upper-left location of the dialog box (in global coordinates). If you set the dialogOptionFlags field to NULL or set this field to (-1,-1), then the dialog box appears in the same location as when last closed. The size and location of the dialog box is persistent, but defaults to opening in the middle of the main screen if any portion is not visible when opened at the persistent location and size. For more information, see Persistence.
A string that identifies your application in the dialog box window title.
A string that you can provide to override the default window title.
An alternative button title for the dialog boxs action button. If you do not specify a title, the button will use the default label (Open or Save, for example.)
An alternative button title for the Cancel button in dialog boxes.
The default filename for a saved file.
The string for the banner, or prompt, below the browser list. This message can provide more descriptive instructions for the user. If you dont provide a message string, the browser list expands to fill that area.
An application-defined value that identifies which set of dialog box preferences Navigation Services should use. If your application maintains multiple sets of preferences for a particular type of dialog box, you can determine which set is active by specifying the appropriate value in the preferenceKey field. For example, an application may allow one set of preferences when it calls the function NavGetFile to open text files and a different set of preferences when opening movie files. If you do not wish to provide a preference key, specify NULL for the preferenceKey value.
A handle to one or more structures of type NavMenuItemSpec used to add extra menu items to the Show pop-up menu in an Open dialog box or the Format pop-up menu in Save dialog boxes. Using NavMenuItemSpec structures allows your application to add additional document types to be opened or saved, or different ways of saving a file (with or without line breaks, for example). For more information, see Customizing Type Pop-up Menus.
The NavDialogOptions structure contains dialog box configuration settings you can pass to several Navigation Services functions.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)