DragonFly On-Line Manual Pages

Search: Section:  


EZ_ConfigureItem(3)             EZWGL Functions            EZ_ConfigureItem(3)

NAME

EZ_ConfigureItem - configure a display item

SYNOPSIS

#include <EZ.h> void EZ_ConfigureItem(EZ_Item *item, ...)

ARGUMENTS

item Specifies a display item. ... Specify configuration options and their values.

DESCRIPTION

EZ_ConfigureItem sets or modifies item attributes, things like label string, color, border. This function takes a variable length arguments, 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.

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_BORDER_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 ALSO

EZ_CreateItem(3), EZ_DestroyItem(3) EZWGL EZ_ConfigureItem(3)

Search: Section: