NAME

       XmVaCreateSimpleMenuBar  —  A  RowColumn  widget  convenience creation function "XmVaCreateSimpleMenuBar"
       "creation functions" "XmVaCreateSimpleMenuBar"

SYNOPSIS

       #include <Xm/RowColumn.h>
       Widget XmVaCreateSimpleMenuBar(
       Widget parent,
       String name);

DESCRIPTION

       XmVaCreateSimpleMenuBar creates an instance of a RowColumn widget of  type  XmMENU_BAR  and  returns  the
       associated  widget  ID.   This  routine  uses  the ANSI C variable-length argument list (varargs) calling
       convention.

       This routine creates a MenuBar and  its  CascadeButtonGadget  children.   The  name  of  each  button  is
       button_n,  where n is an integer from 0 (zero) to the number of buttons in the menu minus 1.  Buttons are
       named and created in the order in which they are specified in the variable portion of the argument list.

       parent    Specifies the parent widget ID

       name      Specifies the name of the created widget

       The variable portion of the argument list consists of groups of arguments.  The first  argument  in  each
       group  is  a constant or a string and determines which arguments follow in that group.  The last argument
       in the list must be NULL.  Following are the possible first arguments in each group of varargs:

       XmVaCASCADEBUTTON
                 This is followed by two additional arguments. The set specifies one button in the  MenuBar  and
                 some of its resource values. Following are the additional two arguments, in order:

                 label     The label string, of type XmString

                 mnemonic  The mnemonic, of type KeySym

       resource_name
                 This  is  followed by one additional argument, the value of the resource, of type XtArgVal. The
                 pair specifies a resource and its value for the RowColumn widget.

       XtVaTypedArg
                 This is followed by four additional arguments. The set specifies a resource and its  value  for
                 the  RowColumn  widget. A resource type conversion is performed if necessary. Following are the
                 additional four arguments, in order:

                 name      The resource name, of type String

                 type      The type of the resource value supplied, of type String

                 value     The resource value (or a pointer to the resource value, depending  on  the  type  and
                           size of the value), of type XtArgVal

                 size      The size of the resource value in bytes, of type int

       XtVaNestedList
                 This  is  followed  by one additional argument of type XtVarArgsList. This argument is a nested
                 list of varargs returned by XtVaCreateArgsList.

       For more information on variable-length argument lists, see the X Toolkit Intrinsics documentation.

       A number of resources exist specifically for use with this and other simple menu creation routines.   For
       a complete definition of RowColumn and its associated resources, see XmRowColumn(3).

RETURN

       Returns the RowColumn widget ID.

RELATED

       XmCreateMenuBar(3), XmCreateRowColumn(3), XmCreateSimpleMenuBar(3), and XmRowColumn(3).

                                                                                      XmVaCreateSimpleMenuBar(3)