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

FreeBSD Manual Pages

  
 
  

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

NAME
     XmCreatePopupMenu -- A RowColumn widget convenience creation function

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

DESCRIPTION
     XmCreatePopupMenu	creates  an  instance  of a RowColumn widget of type Xm-
     MENU_POPUP and returns the associated widget ID. When this function is used
     to create the Popup menu pane, a MenuShell widget is automatically  created
     as  the parent of the menu pane.  The parent of the MenuShell widget is the
     widget indicated by the parent parameter.

     XmCreatePopupMenu is provided as a convenience function for  creating  Row-
     Column  widgets configured to operate as Popup menu panes and is not imple-
     mented as a separate widget class.

     The PopupMenu is used as the first menu pane within a PopupMenu system; all
     other menu panes are of the Pulldown type. A Popup menu pane displays a 3-D
     shadow, unless the feature is disabled by the application.  The shadow  ap-
     pears around the edge of the menu pane.

     The  Popup  menu pane must be created as the child of a MenuShell widget in
     order to function properly when it is incorporated into a menu.  If the ap-
     plication uses this convenience function for creating a  Popup  menu  pane,
     the MenuShell is automatically created as the real parent of the menu pane.
     If  the  application  does  not use this convenience function to create the
     RowColumn to function as a Popup menu pane, it is the application's respon-
     sibility to create the MenuShell widget.

     To access the PopupMenu, the application must first position the widget us-
     ing the XmMenuPosition function and then manage it using XtManageChild.

     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)

     Popup  menu  panes support tear-off capabilities for tear-off menus through
     XmRowColumn resources.  For a complete definition of RowColumn and its  as-
     sociated resources, see XmRowColumn(3).

RETURN
     Returns the RowColumn widget ID.

RELATED
     XmCreateSimplePopupMenu(3),  XmMenuPosition(3),  XmMenuShell(3),  XmRowCol-
     umn(3), and XmVaCreateSimplePopupMenu(3).

							    XmCreatePopupMenu(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmCreatePopupMenu&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help