PA_Dial4DSetVariable

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

PA_Dial4DGetVariable .

Error Handling

None.