EZ_CreateItem(3) EZWGL Functions EZ_CreateItem(3)NAMEEZ_CreateItem - create a display item
SYNOPSIS
#include <EZ.h>
EZ_Item *EZ_CreateItem(int type, ...)
ARGUMENTS
type Specifies a symbolic item type. It must be one of EZ_LABEL_ITEM or
EZ_WIDGET_ITEM.
... Specifies configuration options, a list of symbols each followed
by one or more values. The last symbol must be NULL, which is itself
not followed by any values.
DESCRIPTIONEZ_CreateItem creates a display item and initializes the item using the
specified configuration options. For example
extern EZ_CallBack openXterm(EZ_Item *, void *);
EZ_Item *item;
item = EZ_CreateItem(EZ_LABEL_ITEM, /* type */
/* option, option value(s) */
EZ_LABEL_STRING, "xterm",
EZ_ORIENTATION, EZ_VERTICAL,
EZ_PIXMAP_FILE, "xterm.xpm",
EZ_CALLBACK, openXterm, NULL,
0);
creates a label item, labled by the image "xterm.xpm" on top of
the string 'xterm'. It also associates a callback 'openXterm'
procedure to the item.
Currently, only two types of items are supported.
CONFIGURATION SYMBOLS AND THEIR VALUES
The set of item configuration options and their values are listed
below. For each option value, the string before the last _ is its type.
EZ_BORDER_WIDTH, int_bw
Specifies a border width.
EZ_BORDER_TYPE, int_bt
Specifies a border type. int_bt must be one of EZ_BORDER_NONE,
EZ_BORDER_FLAT, EZ_BORDER_RIDGE, EZ_BORDER_GROOVE, EZ_BOR‐
DER_RAISED or EZ_BORDER_SUNKEN.
EZ_PADX, int_px
Specifies the horizontal padding between the item border and its
contents.
EZ_PADY, int_py
Specifies the vertical padding between the item border and its
contents.
EZ_IPADX, int_ipx
Specifies the amount of spaces to be inserted horizontally between
textual label and image label. It is used only when the item has a
horizontal orientation.
EZ_IPADY, int_ipy
Specifies the amount of spaces to be inserted vertically between
textual label and image label. It is used only when the item has a
vertical orientation.
EZ_ORIENTATION, int_ori
Specifies the orientation of an item. ori must be EZ_HORIZONTAL or
EZ_VERTICAL.
EZ_LABEL_POSITION, int_lp
Specifies a location to anchor a label. int_lp must be one of
EZ_CENTER, EZ_LEFT, EZ_RIGHT, EZ_TOP, EZ_BOTTOM, EZ_TOP_LEFT,
EZ_TOP_RIGHT, EZ_BOTTOM_LEFT or EZ_BOTTOM_RIGHT. This attribute
is used only when an item has been given a size which is larger
than its minimal size.
EZ_LABEL_JUSTIFICATION, int_jst
Specifies the justfication for textual labels. int_jst must be one
of EZ_CENTER, EZ_LEFT or EZ_RIGHT.
EZ_CALLBACK, EZ_CallBack_cbk, voidptr_cdata
Specifies a callback procedure and a client data to be passed to
the callback. Use this option only when an item is to have only
one callback.
EZ_FOREGROUND, str_fg
Specifies a forground color.
EZ_BACKGROUND, str_bg
Specifies a background color.
EZ_PIXMAP_FILE, str_filename
Specifies an X bitmap file or a X pixmap file (an xpm image).
EZ_BITMAP_DATA, array_of_char,int_width,int_height
Specify an X bitmap.
EZ_PIXMAP_DATA, array_of_str
Specifies an XPM image data.
EZ_X_PIXMAP, Pixmap_p,int_x,int_y,int_width,int_height
Specify a rectangular region of a native X pixmap to be used as an
image label.
EZ_LABEL_PIXMAP, EZ_Pixmap_p
Specifies an internal pixmap.
EZ_FONT_ID, int_id
Specifies a fond id.
EZ_FONT_NAME, str_filename
Spcifies an X11 font name.
EZ_TEXT_LINE_LENGTH, int_len
Specifies the wrap around length for textual labels.
EZ_IMAGE_FILE, str_name
Specifies an image file name. Supported image formats are: ppm,
xpm, bmp, gif and jpeg.
EZ_LABEL_STRING, str_label
Specifies a textual label.
EZ_CLIENT_PTR_DATA, ptr_data
Specifies a generic pointer to be stored in a item.
EZ_CLIENT_INT_DATA, int_data
Specifies an integer to be stored in a item.
EZ_DESTROY_CALLBACK, EZ_CallBack_callback, ptr_data
Specify a destroy callback and a client data to be passed to the
callback. Use this option only when an item is to have only one
destroy callback.
EZ_DND_DRAG_CURSOR, Cursor_cur
Specifies an X cursor for drag and drop. The specified cursor will
replace the default cursor when the item is being draged.
EZ_DND_BUBBLE_HELP, str_hlp
Specifies a DND bubble help string. DND bubble will be displayed
when a drag is paused over an item and the item is a drop site.
EZ_X, int_x
Specifies the x coordinate of the upper-left corner of an item in
its hosting window.
EZ_Y, int_y
Specifies the y coordinate of the upper-left corner of an item in
its hosting window.
EZ_WIDTH, int_w
Specifies the width of an item.
EZ_HEIGHT, int_h
Specifies the height of an item.
EZ_LOCATION, int_x, int_y
Specify the coordinates of the upper-left corner of an item in its
hosting window.
EZ_SIZE, int_w, int_h
Specify the width and height of an item.
SEE ALSOEZ_ConfigureItem(3), EZ_DestroyItem(3)EZWGLEZ_CreateItem(3)
