PA_Dial4DGetArrayString

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

version 2003


PA_Dial4DGetArrayString (dialog; variable; string; index)

ParameterTypeDescription
dialogPA_Dial4DDialog reference
variablechar*Name of the array to access
stringchar*Value of the element
indexlongElement to access

Description

The routine PA_Dial4DGetArrayString retrieves a string from a string/text array .

variable is the name of the array. This array can be created externally using PA_Dial4DNewArrayString, or it can be created using 4th Dimension code in the form.

By default, variable and string are null terminated C strings. If you have previously called PA_UsePStrings you must pass and you will receive a Pascal string from the command.

By default, varName and string 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

Get the current value of a string array.

   void Dial4D_GetCurrentStringElement( PA_Dial4D ref, char *variable, char *value )
   {
      long   index = PA_Dial4DGetLong( ref, variable );
      return PA_Dial4DGetArrayReal( ref, variable, value, index );
   }

See Also

PA_Dial4DNewArrayString, PA_Dial4DSetArrayString.

Error Handling

None.


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