![]() |
PATH![]() |
![]() ![]() |
Your application can provide an event-handling function to update application windows and handle other events related to your Open and Save dialog boxes. Navigation Services informs you of pertinent events by supplying event message constants to your event-handling function via the
param
field of the structure of type NavCBRec
. These constants are defined in the
NavEventCallbackMessages
data type. For more information, see Handling Events.
enum {
kNavCBEvent = 0, /* event has occurred */
kNavCBCustomize = 1, /* signal to negotiate
customization space */
kNavCBStart = 2, /* nav dialog box starting up */
kNavCBTerminate = 3, /* nav dialog box closing down */
kNavCBAdjustRect = 4, /* nav dialog box being resized */
kNavCBNewLocation = 5, /* user chose new location*/
kNavCBShowDesktop = 6, /* user navigated to the desktop */
kNavCBSelectEntry = 7, /* user made selection in browser */
kNavCBPopupMenuSelect = 8, /* user made popup menu selection */
kNavCBAccept = 9, /* user accepted nav dialog box */
kNavCBCancel = 10, /* user cancelled nav dialog box */
kNavCBAdjustPreview = 11 /* preview toggled or resized */
}
typedef UInt32 NavEventCallbackMessages;
NavCBRec
. The
kNavCBEvent
constant is the only message that needs to be processed by most applications that do not customize Open and Save dialog boxes.NOTE
Don't add new dialog box items until your application receives the kNavCBStart event message constant.
NavCBRec
to determine the new customization rectangle size. Your application does not need to offset the controls; Navigation Services moves them automatically. Your application is responsible for any redrawing of the controls or handling events beyond moving the controls, however. For more information, see Adding Custom Controls.NavMenuItemSpec
describing the pop-up menu item selected. This data is valid only during the execution of your event-handling function.