VGetTextIdByLabel


 
Name
  VGetTextIdByLabel - returns the ID of a Text (Tablet) Item given a label.
 
Synopsis
  VGetTextIdByLabel(text, ID)
  char *text;
  int *ID;                              /*RETURN*/
 
Description
  VGetTextIdByLabel returns the ID of a Text (Tablet) Item given a label.
 
Return Value
  0 - work successfully.
  266 - invalid Text Item ID.
  269 - no Text Item found.
 
Parameters
  text - string representing the label of the Text Item.
  ID - Text Item ID of item to be found.
 
Side Effects
  None.
 
Entry Conditions
  VCreateColormap should be called earlier, else VGetTextIdByLabel prints
an error message to the standard error stream, produces a core dump file and
exits from the current process.
 
Related Functions
VAddText, VGetTextValueByLabel.