1XmCreatePopupMenu(library call) XmCreatePopupMenu(library call)
2
3
4
6 XmCreatePopupMenu — A RowColumn widget convenience creation function
7
9 #include <Xm/RowColumn.h>
10 Widget XmCreatePopupMenu(
11 Widget parent,
12 String name,
13 ArgList arglist,
14 Cardinal argcount);
15
17 XmCreatePopupMenu creates an instance of a RowColumn widget of type
18 XmMENU_POPUP and returns the associated widget ID. When this function
19 is used to create the Popup menu pane, a MenuShell widget is automati‐
20 cally created as the parent of the menu pane. The parent of the
21 MenuShell widget is the widget indicated by the parent parameter.
22
23 XmCreatePopupMenu is provided as a convenience function for creating
24 RowColumn widgets configured to operate as Popup menu panes and is not
25 implemented as a separate widget class.
26
27 The PopupMenu is used as the first menu pane within a PopupMenu system;
28 all other menu panes are of the Pulldown type. A Popup menu pane dis‐
29 plays a 3-D shadow, unless the feature is disabled by the application.
30 The shadow appears around the edge of the menu pane.
31
32 The Popup menu pane must be created as the child of a MenuShell widget
33 in order to function properly when it is incorporated into a menu. If
34 the application uses this convenience function for creating a Popup
35 menu pane, the MenuShell is automatically created as the real parent of
36 the menu pane. If the application does not use this convenience func‐
37 tion to create the RowColumn to function as a Popup menu pane, it is
38 the application's responsibility to create the MenuShell widget.
39
40 To access the PopupMenu, the application must first position the widget
41 using the XmMenuPosition function and then manage it using XtMan‐
42 ageChild.
43
44 parent Specifies the parent widget ID
45
46 name Specifies the name of the created widget
47
48 arglist Specifies the argument list
49
50 argcount Specifies the number of attribute/value pairs in the argument
51 list (arglist)
52
53 Popup menu panes support tear-off capabilities for tear-off menus
54 through XmRowColumn resources. For a complete definition of RowColumn
55 and its associated resources, see XmRowColumn(3).
56
58 Returns the RowColumn widget ID.
59
61 XmCreateSimplePopupMenu(3), XmMenuPosition(3), XmMenuShell(3), XmRow‐
62 Column(3), and XmVaCreateSimplePopupMenu(3).
63
64
65
66 XmCreatePopupMenu(library call)