version 2003
PA_Dial4DSaveVariables (dialog) void*
Parameter | Type | Description | |
dialog | PA_Dial4D | Dialog reference | |
Function result | void* | Pointer to the dialog context |
Description
The routine PA_Dial4DSaveVariables returns a pointer to the dialog context referenced by dialog.
Dialogs use their own variable context. If you want to access the current process variables, you must switch from dialog variables to current process variables. This is done using PA_Dial4DSaveVariables. Once the process variables have been accessed, the plug-in MUST counter balance the previous call to PA_Dial4DSaveVariables by a call to PA_Dial4DRestoreVariables (passing it the value returned by PA_Dial4DSaveVariables) to switch back from process variables to dialog variables.
Example
Sample use of the two routines :
char *toDialogContext; PA_Variable var; toDialogContext = (char *) PA_Dial4DSaveVariables(); /* . . . access process variables . . . */ var = PA_GetVariable( "aVariable" ); PA_Dial4DRestoreVariables( toDialogContext );
See Also
PA_Dial4DRestoreVariables, PA_GetVariable.
Error Handling
None.