VGetTextValueByLabel


 
Name
  VGetTextValueByLabel - returns the value of a Text (Tablet) Item given a 
label.
 
Synopsis
  VGetTextValueByLabel(text, val)
  char *text;
  char  *val;                           /*RETURNS upto 200 characters*/
 
Description
  VGetTextValueByLabel returns the value of a Text (Tablet) Item given a 
label.
 
Return Value
  0 - work successfully.
  266 - invalid Text Item ID.
  269 - no Text Item found.
  271 - invalid Text Item value pointer.
 
Parameters
  text - string representing the label of a Text Item.
  val  - character string in which the value is returned.
 
Side Effects
  None.
 
Entry Conditions
  VCreateColormap should be called earlier, else VGetTextValueByLabel prints
an error message to the standard error stream, produces a core dump file and
exits from the current process.
 
Related Functions
VGetTextValue, VAddText, VCheckTextEvent, VSetTextOn.