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

FreeBSD Manual Pages


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

       XmCreatePopupMenu -- A RowColumn	widget convenience creation function

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

       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
       RowColumn widgets configured to operate as Popup	menu panes and is  not
       implemented 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  dis-
       plays  a	3-D shadow, unless the feature is disabled by the application.
       The shadow appears 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 application 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	 func-
       tion  to	 create	 the RowColumn to function as a	Popup menu pane, it is
       the application's responsibility	to create the MenuShell	widget.

       To access the PopupMenu,	the application	must first position the	widget
       using  the  XmMenuPosition  function  and  then	manage it using	XtMan-

       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 associated resources, see XmRowColumn(3).

       Returns the RowColumn widget ID.

       XmCreateSimplePopupMenu(3),  XmMenuPosition(3),	XmMenuShell(3),	XmRow-
       Column(3), and XmVaCreateSimplePopupMenu(3).



Want to link to this manual page? Use this URL:

home | help