1XmCreateMenuBar(library call)                    XmCreateMenuBar(library call)
2
3
4

NAME

6       XmCreateMenuBar — A RowColumn widget convenience creation function
7

SYNOPSIS

9       #include <Xm/RowColumn.h>
10       Widget XmCreateMenuBar(
11       Widget parent,
12       String name,
13       ArgList arglist,
14       Cardinal argcount);
15

DESCRIPTION

17       XmCreateMenuBar  creates  an  instance  of  a  RowColumn widget of type
18       XmMENU_BAR and returns the associated widget ID. It is  provided  as  a
19       convenience function for creating RowColumn widgets configured to oper‐
20       ate as a MenuBar and is not implemented as a separate widget class.
21
22       The MenuBar widget is generally used for building a Pulldown menu  sys‐
23       tem.  Typically,  a  MenuBar is created and placed along the top of the
24       application window, and several  CascadeButtons  are  inserted  as  the
25       children.  Each  of the CascadeButtons has a Pulldown menu pane associ‐
26       ated with it.  These Pulldown menu panes  must  have  been  created  as
27       children  of the MenuBar.  The user interacts with the MenuBar by using
28       either the mouse or the keyboard.
29
30       The MenuBar displays a 3-D shadow along  its  border.  The  application
31       controls  the shadow attributes using the visual-related resources sup‐
32       ported by XmManager.
33
34       The MenuBar widget is homogeneous in that it accepts only children that
35       are a subclass of XmCascadeButton or XmCascadeButtonGadget.  Attempting
36       to insert a child of a different class results in a warning message.
37
38       If the MenuBar does not have enough room to fit all of  its  subwidgets
39       on  a  single  line, the MenuBar attempts to wrap the remaining entries
40       onto additional lines if allowed by the geometry manager of the  parent
41       widget.
42
43       parent    Specifies the parent widget ID
44
45       name      Specifies the name of the created widget
46
47       arglist   Specifies the argument list
48
49       argcount  Specifies the number of attribute/value pairs in the argument
50                 list (arglist)
51
52       For a complete definition of RowColumn and  its  associated  resources,
53       see XmRowColumn(3).
54

RETURN

56       Returns the RowColumn widget ID.
57
59       XmCascadeButton(3),  XmCascadeButtonGadget(3), XmCreatePulldownMenu(3),
60       XmCreateSimpleMenuBar(3), XmManager(3),  XmRowColumn(3),  and  XmVaCre‐
61       ateSimpleMenuBar(3).
62
63
64
65                                                 XmCreateMenuBar(library call)
Impressum