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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmCreatePulldownMenu  --	 A RowColumn widget convenience	creation func-
       tion

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

DESCRIPTION
       XmCreatePulldownMenu creates an instance	of a RowColumn widget of  type
       XmMENU_PULLDOWN and returns the associated widget ID.

       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)

       Specifies the number of attribute/value pairs in	the argument list (ar-
       glist).	When this function is used to create the Pulldown menu pane, a
       MenuShell widget	is automatically created as the	 parent	 of  the  menu
       pane.  If  the widget specified by the parent parameter is a Popup or a
       Pulldown	menu pane, the MenuShell widget	is created as a	child  of  the
       parent  MenuShell; otherwise, it	is created as a	child of the specified
       parent widget.

       XmCreatePulldownMenu is provided	as a convenience function for creating
       RowColumn  widgets  configured to operate as Pulldown menu panes	and is
       not implemented as a separate widget class.

       A Pulldown menu pane displays a 3-D shadow, unless the feature is  dis-
       abled  by  the  application.  The shadow	appears	around the edge	of the
       menu pane.

       A Pulldown menu pane is used with submenus that are to be attached to a
       CascadeButton  or  a CascadeButtonGadget. This is the case for all menu
       panes that are part of a	PulldownMenu system (a MenuBar), the menu pane
       associated  with	 an OptionMenu,	and any	menu panes that	cascade	from a
       Popup menu pane.	Pulldown menu panes that are to	be associated with  an
       OptionMenu must be created before the OptionMenu	is created.

       The  Pulldown menu pane must be attached	to a CascadeButton or Cascade-
       ButtonGadget that resides in a MenuBar, a Popup menu pane,  a  Pulldown
       menu  pane,  or	an OptionMenu. It is attached with the button resource
       XmNsubMenuId.

       A MenuShell widget is required between the Pulldown menu	pane  and  its
       parent.	If the application uses	this convenience function for creating
       a Pulldown menu pane, the MenuShell is  automatically  created  as  the
       real  parent  of	 the menu pane;	otherwise, it is the application's re-
       sponsibility to create the MenuShell widget.

       To function correctly when incorporated into a menu, the	Pulldown  menu
       pane's hierarchy	must be	considered. This hierarchy depends on the type
       of menu system that is being built, as follows:

	  o  If	the Pulldown menu pane is to be	pulled down  from  a  MenuBar,
	     its parent	must be	the MenuBar.

	  o  If	 the  Pulldown	menu pane is to	be pulled down from a Popup or
	     another Pulldown menu pane, its parent  must  be  that  Popup  or
	     Pulldown menu pane.

	  o  If	 the  Pulldown	menu pane is to	be pulled down from an Option-
	     Menu, its parent must be the same as the OptionMenu parent.

       PullDown	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).

RETURN
       Returns the RowColumn widget ID.

RELATED
       XmCascadeButton(3),  XmCascadeButtonGadget(3),	XmCreateOptionMenu(3),
       XmCreatePopupMenu(3),   XmCreateSimplePulldownMenu(3),  XmMenuShell(3),
       XmRowColumn(3), and XmVaCreateSimplePulldownMenu(3).

						       XmCreatePulldownMenu(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmCreatePulldownMenu&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help