Dialog Action Callbacks
Functions Introduced
• ProUIDialogPremanagenotifyActionSet()
• ProUIDialogPostmanagenotifyActionSet()
• ProUIDialogDestroynotifyActionSet()
• ProUIDialogCloseActionSet()
• ProUIDialogActivateActionSet()
• ProUIDialogAppActionSet()
• ProUIDialogAppActionRemove()
Use the function ProUIDialogPremanagenotifyActionSet() to set the function to be called when the dialog is about to be managed. For example, when a dialog box is displayed or redisplayed.
Use the function ProUIDialogPostmanagenotifyActionSet() to set the function to be called when the dialog has just been managed. For example, when a dialog box is displayed.
Use the function ProUIDialogDestroynotifyActionSet() to set the function to be called when the dialog is about to be destroyed.
Use the function ProUIDialogCloseActionSet() to set the action function to be called when the user attempts to close the dialog using the window close icon in the upper right corner of the dialog.
Use the function ProUIDialogActivateActionSet() to set the function to be called when the dialog has just been activated and made the current foreground window. The action function for a given dialog can be called
• The dialog must not be the current foreground application.
• The dialog (when it is not the foreground application) is activated using one of the following methods:
◦ When the user clicks on the taskbar button for the given dialog.
◦ When the user switches to the given dialog using Alt+Tab.
◦ When the user clicks within the given dialog.
Use the function ProUIDialogAppActionSet() to set a function to be called only once, when you return to or enter an event loop. The input arguments follow:
• dialog—Name of the dialog. The action is associated with the dialog and is automatically cancelled if the dialog is destroyed. The value can be NULL.
• function—Function to be called when you return to an event loop.
• data—Action data passed to the callback function. The value can be NULL.
Use the function ProUIDialogAppActionRemove() to remove a function added via ProUIDialogAppActionSet(). The input arguments follow:
• dialog—Name of the dialog passed to the function ProUIDialogAppActionRemove().
• function— Function passed to ProUIDialogActionSet().
• data—Action data passed to ProUIDialogActionSet().