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

NAME

6       XmCreatePopupMenu — A RowColumn widget convenience creation function
7

SYNOPSIS

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

DESCRIPTION

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

RETURN

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