1XmCreateMenuBar(library call) XmCreateMenuBar(library call)
2
3
4
6 XmCreateMenuBar — A RowColumn widget convenience creation function
7
9 #include <Xm/RowColumn.h>
10 Widget XmCreateMenuBar(
11 Widget parent,
12 String name,
13 ArgList arglist,
14 Cardinal argcount);
15
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
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)