XmCreatePulldownMenu man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

XmCreatePulldownMenu(3X)	   OSF/Motif	      XmCreatePulldownMenu(3X)

NAME
       XmCreatePulldownMenu - A RowColumn widget convenience creation function

SYNOPSIS
       #include <Xm/RowColumn.h>

       Widget XmCreatePulldownMenu (parent, name, arglist, argcount)	  Wid‐
       get    parent;	   String    name;	ArgList	  arglist;	Cardi‐
       nal  argcount;

DESCRIPTION
       XmCreatePulldownMenu  creates an instance of a RowColumn widget of type
       XmMENU_PULLDOWN and returns the associated widget ID.  When using  this
       function	 to  create the Pulldown MenuPane, a MenuShell widget is auto‐
       matically created as the parent of the MenuPane. If the	widget	speci‐
       fied  by	 the  parent  parameter is a Popup or a Pulldown MenuPane, the
       MenuShell widget is created as a child of the parent's MenuShell;  oth‐
       erwise, 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  MenuPanes  and  is
       not implemented as a separate widget class.

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

       A  Pulldown  MenuPane  is  used	when  creating submenus that are to be
       attached to a CascadeButton or a CascadeButtonGadget.  This is the case
       for  all	 MenuPanes that are part of a PulldownMenu system (a MenuBar),
       the MenuPane associated with an OptionMenu, and any MenuPanes that cas‐
       cade  from a Popup MenuPane.  Pulldown MenuPanes that are to be associ‐
       ated with an OptionMenu must be created before the OptionMenu  is  cre‐
       ated.

       The  Pulldown  MenuPane must be attached to a CascadeButton or Cascade‐
       ButtonGadget that resides in a MenuBar, a Popup	MenuPane,  a  Pulldown
       MenuPane,  or an OptionMenu.  This is done by using the button resource
       XmNsubMenuId.

       A MenuShell widget is required between the Pulldown  MenuPane  and  its
       parent.	If the application uses this convenience function for creating
       a Pulldown MenuPane, the MenuShell is automatically created as the real
       parent of the MenuPane; otherwise, it is the application's responsibil‐
       ity 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: If the Pulldown MenuPane
       is  to  be  pulled down from a MenuBar, its parent must be the MenuBar.
       If the Pulldown MenuPane is to be pulled down from a Popup  or  another
       Pulldown	 MenuPane, its parent must be that Popup or Pulldown MenuPane.
       If the Pulldown MenuPane is to be pulled down from an  OptionMenu,  its
       parent must be the same as the OptionMenu parent.  Specifies the parent
       widget ID Specifies the name of the created widget Specifies the	 argu‐
       ment list Specifies the number of attribute/value pairs in the argument
       list (arglist)

       PullDown MenuPanes support tear-off  capabilities  for  tear-off	 menus
       through	XmRowColumn resources.	For a complete definition of RowColumn
       and its associated resources, see XmRowColumn(3X).

RETURN VALUE
       Returns the RowColumn widget ID.

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

						      XmCreatePulldownMenu(3X)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net