version 2003
PA_Dial4DGetArrayString (dialog; variable; string; index)
Parameter | Type | Description | |
dialog | PA_Dial4D | Dialog reference | |
variable | char* | Name of the array to access | |
string | char* | Value of the element | |
index | long | Element 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.