| # EZ_CreateWidget

##

##

##

##

##

##

##

    NAME
           EZ_CreateWidget, EZ_CreateWidgetXrm - create an EZ widget

    SYNOPSIS
           #include <EZ.h>

           EZ_Widget *EZ_CreateWidget(int type, EZ_Widget *parent, ...)

           EZ_Widget *EZ_CreateWidgetXrm(int type, EZ_Widget *parent,
                       char *name, char *className, ...)

    ARGUMENTS
           type Specifies a symbolic widget type (see below).

           parent Specifies the parent widget or NULL.

           className Specifies a class name.

           name Specifies an instance name.

            ...  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_CreateWidget  creates a widget and initializes the wid-
           get using the specified  configuration  options.  Then  it
           reads  the  resource database and configure the widget use
           resources found in the database.

           EZ_CreateWidgetXrm is equivalent to  EZ_CreateWidget  with
           both EZ_CLASS and EZ_NAME attributes specified.

           Example

              extern void exit();
              EZ_Widget *button;
                                      /* type                   parent */
              button = EZ_CreateWidget(EZ_WIDGET_NORMAL_BUTTON, NULL,
                                       /* option,       option value(s) */
                                       EZ_LABEL_STRING, "Hello World",
                                       EZ_UNDERLINE,    0,
                                       EZ_CALLBACK,     exit, NULL,
                                       0);

           creates a push button widget labeled by "Hello World" with
           the letter 'H' underlined.

    SYMBOLIC WIDGET TYPES
           EZ_WIDGET_FRAME,                  EZ_WIDGET_NORMAL_BUTTON,
           EZ_WIDGET_CHECK_BUTTON,            EZ_WIDGET_RADIO_BUTTON,
           EZ_WIDGET_MENU_BUTTON,           EZ_WIDGET_MENU_SEPARATOR,
           EZ_WIDGET_LABEL,                    EZ_WIDGET_RAW_XWINDOW,
           EZ_WIDGET_MENU_SUBMENU,      EZ_WIDGET_MENU_NORMAL_BUTTON,
           EZ_WIDGET_MENU_CHECK_BUTTON,  EZ_WIDGET_MENU_RADIO_BUTTON,
           EZ_WIDGET_VERTICAL_SLIDER,    EZ_WIDGET_HORIZONTAL_SLIDER,
           EZ_WIDGET_ENTRY,             EZ_WIDGET_VERTICAL_SCROLLBAR,
           EZ_WIDGET_HORIZONTAL_SCROLLBAR,        EZ_WIDGET_LIST_BOX,
           EZ_WIDGET_TEXT,                       EZ_WIDGET_NOTE_BOOK,
           EZ_WIDGET_PANE_HANDLE,                 EZ_WIDGET_EXECUTOR,
           EZ_WIDGET_OPTIONAL_ENTRY,         EZ_WIDGET_FILE_SELECTOR,
           EZ_WIDGET_TREE,                       EZ_WIDGET_LIST_TREE,
           EZ_WIDGET_FANCY_LIST_BOX,             EZ_WIDGET_WORK_AREA,
           EZ_WIDGET_FREE_LABEL,                 EZ_WIDGET_3D_CANVAS,
           EZ_WIDGET_NB_PAGE,                     EZ_WIDGET_NW_LABEL,
           EZ_WIDGET_ICON,                             EZ_WIDGET_LCD,
           EZ_WIDGET_LED,                     EZ_WIDGET_STATUS_METER,
           EZ_WIDGET_MENU_BAR                         EZ_WIDGET_TERM,
           EZ_WIDGET_HORIZONTAL_RULER,      EZ_WIDGET_VERTICAL_RULER,
           EZ_WIDGET_SCROLL_BUTTON,            EZ_WIDGET_SPIN_BUTTON,
           EZ_WIDGET_LOCATOR,                         EZ_WIDGET_DIAL,
           EZ_WIDGET_GRADIENT_BAR,               EZ_WIDGET_HISTOGRAM,
           EZ_WIDGET_SPREAD_SHEET,             EZ_WIDGET_THUMB_WHEEL,

    CONFIGURATION SYMBOLS AND THEIR VALUES
           See  manual for a complete list of resources/configuration
           options.

    SEE ALSO
           EZ_DisplayWidget(3), EZ_ConfigureWidget(3), EZ_DestroyWidget(3)