version 2003
PA_Dial4DSetVariable (dialog; variable; newVarValue)
Parameter | Type | Description | |
dialog | PA_Dial4D | Dialog reference | |
variable | char* | Name of the variable to access | |
newVarValue | PA_Variable | New value for the variable |
Description
The routine PA_Dial4DSetVariable changes the value of the variable named variable in the dialog referenced by dialog, to the PA_Variable newVarValue.
Note that it is probably much easier to use Get/Set direct accessors to variable values, such as PA_Dial4DSetDate, PA_Dial4DSetReal, PA_Dial4DSetArrayLong.
By default, variable needs to be a null terminated C string. If you have previously called PA_UsePStrings, you must pass a Pascal string to the command.
By default, variable needs to use Macintosh characters set on Macintosh, and ANSI characters set under Windows. You can call PA_UseMacCharacters or PA_UseAnsiCharacters to specifically use Macintosh or ANSI characters.
Example
Change the value of "aVariable", in the dialog "dRef".
PA_Variable v; PA_SetStringVariable( &v, "New value"); PA_Dial4DSetVariable( dRef, "aVariable", v);
See Also
Error Handling
None.