VSetButtonLabel


 
Name
  VSetButtonLabel - sets the label of a given Button Item.
 
Synopsis
  VSetButtonLabel(item, label)
  BUTTON *item;
  char *label;
 
Description
  VSetButtonLabel sets the label of a given Button Item. Please note that
VSetButtonLabel should not be called for a panel button (see 
VChangePanelItem).
 
Structures
  typedef struct _button {
        Window  win;            /*window in which item resides*/
        short   type;           /*type of button(0=button, 1=toggle, etc..)*/
        short   x,y;            /*location of upper-left corner of item*/
        short   w;              /*width of the item area in fonts*/
        short   h;              /*height of the item area in fonts*/
        short   label_width;    /*width of label in pixels*/
        short   label_height;   /*height of label*/
        short   label_ascent;   /*ascent dimension of font*/
        short   label_x;        /*position of the label*/
        short   label_y;
        short   thick;          /*thickness of frame*/
        short   width;          /*width of item in pixels*/
        short   height;         /*height of item in pixels*/
        int     fw,fh;          /*size of font*/
        char    label[150];     /*label of the button item*/
        short   state;          /*indicates if button item is OFF(0) / ON(1)*/
        short   mode;           /*0=RELEASED, 1=PRESSED*/
        int     (*func)();      /*notify procedure*/
        struct _button *next;   /*next button item*/
  } BUTTON;
 
Return Value
  0 - work successfully.
  266 - invalid Button Item ID.
 
Parameters
  item - ID for the Button Item.
  label - character string of new value.
 
Side Effects
  The value of the Button Item is changed. The Button Item is redisplayed,
if it is already on.
 
Entry Conditions
  None.
 
Related Functions
VAddButton.