Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmCreateMenuBar(3)	   Library Functions Manual	    XmCreateMenuBar(3)

       XmCreateMenuBar -- A RowColumn widget convenience creation function

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

       XmCreateMenuBar	creates	 an instance of	a RowColumn widget of type Xm-
       MENU_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  sys-
       tem.  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 associ-
       ated 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

       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).

       Returns the RowColumn widget ID.

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



Want to link to this manual page? Use this URL:

home | help