xmcreatemenubar(3) [centos man page]

XmCreateMenuBar(library call)											     XmCreateMenuBar(library call)

NAME

       XmCreateMenuBar -- A RowColumn widget convenience creation function

SYNOPSIS

       #include <Xm/RowColumn.h>
       Widget XmCreateMenuBar(
       Widget parent,
       String name,
       ArgList arglist,
       Cardinal argcount);

DESCRIPTION

       XmCreateMenuBar creates an instance of a RowColumn widget of type XmMENU_BAR and returns the associated widget ID. It is provided as a con-
       venience function for creating RowColumn widgets configured to operate as a MenuBar and is not implemented as a separate widget class.

       The MenuBar widget is generally used for building a Pulldown menu system. Typically, a MenuBar is created and placed along the top  of  the
       application window, and several CascadeButtons are inserted as the children. Each of the CascadeButtons has a Pulldown menu pane associated
       with it.  These Pulldown menu panes must have been created as children of the MenuBar.  The user interacts with the MenuBar by using either
       the mouse or the keyboard.

       The  MenuBar displays a 3-D shadow along its border. The application controls the shadow attributes using the visual-related resources sup-
       ported by XmManager.

       The MenuBar widget is homogeneous in that it accepts only children  that  are  a  subclass  of  XmCascadeButton	or  XmCascadeButtonGadget.
       Attempting to insert a child of a different class results in a warning message.

       If  the MenuBar does not have enough room to fit all of its subwidgets on a single line, the MenuBar attempts to wrap the remaining entries
       onto additional lines if allowed by the geometry manager of the parent widget.

       parent	 Specifies the parent widget ID

       name	 Specifies the name of the created widget

       arglist	 Specifies the argument list

       argcount  Specifies the number of attribute/value pairs in the argument list (arglist)

       For a complete definition of RowColumn and its associated resources, see XmRowColumn(3).

RETURN

       Returns the RowColumn widget ID.

RELATED

       XmCascadeButton(3), XmCascadeButtonGadget(3), XmCreatePulldownMenu(3), XmCreateSimpleMenuBar(3), XmManager(3), XmRowColumn(3), and XmVaCre-
       ateSimpleMenuBar(3).

														     XmCreateMenuBar(library call)

XmCreatePulldownMenu(3X)												  XmCreatePulldownMenu(3X)

NAME

       XmCreatePulldownMenu - A RowColumn widget convenience creation function

SYNOPSIS

       #include <Xm/RowColumn.h>

       Widget XmCreatePulldownMenu (parent, name, arglist, argcount)
	       Widget parent;
	       String name;
	       ArgList arglist;
	       Cardinal argcount;

DESCRIPTION

       XmCreatePulldownMenu  creates  an  instance of a RowColumn widget of type XmMENU_PULLDOWN and returns the associated widget ID.	When using
       this function to create the Pulldown MenuPane, a MenuShell widget is automatically created as the parent of the	MenuPane.  If  the  widget
       specified  by the parent parameter is a Popup or a Pulldown MenuPane, the MenuShell widget is created as a child of the parent's MenuShell;
       otherwise, it is created as a child of the specified parent widget.

       XmCreatePulldownMenu is provided as a convenience function for creating RowColumn widgets configured to operate as Pulldown  MenuPanes  and
       is not implemented as a separate widget class.

       A  Pulldown  MenuPane  displays	a 3-D shadow, unless the feature is disabled by the application. The shadow appears around the edge of the
       MenuPane.

       A Pulldown MenuPane is used when creating submenus that are to be attached to a CascadeButton or a CascadeButtonGadget.	This is  the  case
       for  all  MenuPanes  that are part of a PulldownMenu system (a MenuBar), the MenuPane associated with an OptionMenu, and any MenuPanes that
       cascade from a Popup MenuPane.  Pulldown MenuPanes that are to be associated with an OptionMenu must be created before  the  OptionMenu	is
       created.

       The  Pulldown  MenuPane	must be attached to a CascadeButton or CascadeButtonGadget that resides in a MenuBar, a Popup MenuPane, a Pulldown
       MenuPane, or an OptionMenu.  This is done by using the button resource XmNsubMenuId.

       A MenuShell widget is required between the Pulldown MenuPane and its parent. If the application uses this convenience function for creating
       a  Pulldown MenuPane, the MenuShell is automatically created as the real parent of the MenuPane; otherwise, it is the application's respon-
       sibility to create the MenuShell widget.

       To function correctly when incorporated into a menu, the Pulldown MenuPane's hierarchy must be considered; this hierarchy  depends  on  the
       type  of  menu  system that is being built as follows: If the Pulldown MenuPane is to be pulled down from a MenuBar, its parent must be the
       MenuBar.  If the Pulldown MenuPane is to be pulled down from a Popup or another Pulldown MenuPane, its parent must be that Popup  or  Pull-
       down  MenuPane.	 If  the  Pulldown MenuPane is to be pulled down from an OptionMenu, its parent must be the same as the OptionMenu parent.
       Specifies the parent widget ID Specifies the name of the created widget Specifies the argument list Specifies the number of attribute/value
       pairs in the argument list (arglist)

       PullDown  MenuPanes  support tear-off capabilities for tear-off menus through XmRowColumn resources. For a complete definition of RowColumn
       and its associated resources, see XmRowColumn(3X).

RETURN VALUE

       Returns the RowColumn widget ID.

SEE ALSO

       XmCascadeButton(3X),    XmCascadeButtonGadget(3X),    XmCreateOptionMenu(3X),	XmCreatePopupMenu(3X),	   XmCreateSimplePulldownMenu(3X),
       XmMenuShell(3X), XmRowColumn(3X), XmVaCreateSimplePulldownMenu(3X)

															  XmCreatePulldownMenu(3X)