VSetButtonOff


 
Name
  VSetButtonOff - turns a Button Item OFF. 
 
Synopsis
  VSetButtonOff(item)
  BUTTON *item;
 
Description
  VSetButtonOff turns a Button Item OFF. The Button Item is erased and it 
doesn't exist for interaction purposes until it is turned ON. Please note
that VSetButtonOff cannot be used for panel buttons (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.
 
Side Effect
  The 'state' element of the Button Item's structure is changed. 
 
Entry Conditions
  None.
 
Related Functions
VSetButtonOn.