PA_Dial4DGetString

version 2003

PA_Dial4DGetString (dialog; variable; string)

Parameter	Type		Description
dialog	PA_Dial4D	→	Dialog reference
variable	char*	→	Name of the variable to access
string	char*	←	Value of the string/text variable

Description

The routine PA_Dial4DGetString gets the value of a variable whose name is variable as a string in string .

By default, variable and string are null terminated C strings. If you have previously called PA_UsePStrings, the command will expect and return Pascal string.

By default, variable 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

Check if an enterable string variable is empty.

   char Dial_IsEmptyString( PA_Dial4D dialog, char *variable )
   {
      char   varValue;
 
      PA_Dial4DGetString( dialogRef, "theVariable", string );
      return (char) varValue[0] == O ? 1 : 0;
   }

See Also

PA_Dial4DSetString .

Error Handling

None.