VDeleteButton
Name
VDeleteButton - removes a Button Item from the list.
Synopsis
VDeleteButton(ID)
BUTTON *ID;
Description
VDeleteButton removes the Button Item from the list and erases the button
from the window it is diaplyed in. The memory space occupied by the Button
Item is also freed. Please note that VDeleteButton should not be used for a
panel button (see VErasePanel).
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
ID - the ID of the Button Item to be deleted.
Side Effects
An entry is removed from the Button Item list. The region occupied by the
Item is erased.
Entry Conditions
VCreateColormap should be called earlier, else VDeleteButton prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
Related Functions
VAddButton,
VClearButtonList,
VSetButtonOff.