Category Custom user interface, Object ProUIDialog

Function ProUIDialogActivateActionSet


Description
Sets the function that is called when the dialog has become the current foreground window.

Note: The callback for a given Dialog is generated only on windows platform under the following conditions:
1. The dialog must not be the current foreground application.
2. 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.
Synopsis
#include <ProUIDialog.h>
ProErrorProUIDialogActivateActionSet(
char* dialog
/* (In)
The name of the dialog.
*/
ProUIAction callback
/* (In)
The action to perform
*/
ProAppData data
/* (In)
Data to be passed to callback function Can be NULL.
*/
)
Returns
PRO_TK_NO_ERRORThe function was successful
PRO_TK_GENERAL_ERRORThe function failed
PRO_TK_BAD_INPUTSAn invalid argument was given

Manual References:

  1. User Interface: Dialogs: Dialog Action Callbacks
  2. User Interface: Dialogs: Dialog Action Callbacks