DragonFly On-Line Manual Pages

EZ_CreateItem(3)                EZWGL Functions               EZ_CreateItem(3)

NAME
       EZ_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.

DESCRIPTION
       EZ_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_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_ConfigureItem(3), EZ_DestroyItem(3)

EZWGL                                                         EZ_CreateItem(3)