PA_Dial4DSetVariable

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_Dial4DSetVariable (dialog; variable; newVarValue)

ParameterTypeDescription
dialogPA_Dial4DDialog reference
variablechar*Name of the variable to access
newVarValuePA_VariableNew 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.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next