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.