PA_Dial4DGetText

version 2003

PA_Dial4DGetText (dialog; variable; text) long

Parameter	Type		Description
dialog	PA_Dial4D		Dialog reference
variable	char*		Name of the variable to access
text	char*		Pointer to the buffer that will receive the text
Function result	long		Length of the text

The routine PA_Dial4DGetText returns the text for the variable variable in the buffer pointed to by text. The function returns the length of the text. You can pass a null buffer pointer if you only want to read the length of the text.

   char* text = 0;
   long len;

   // first read the size of the buffer, passing a null pointer
   len = PA_Dial4DGetText( dialog, "vText", 0 );
   
   // if there is a text, allocate a buffer to hold it
   if ( len > 0 )
      text = malloc( len );
   
   // if buffer is allocated, get the text
   if ( text )
   {
      PA_Dial4DGetText( dialog, "vText", text );
      
      /* . . . */
      
      //   free the buffer when it's done with it   
      free( text );
   }

PA_Dial4DSetText.

None.