Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for xmcreatepulldownmenu (redhat section 3)

XmCreatePulldownMenu(library call)			       XmCreatePulldownMenu(library call)

NAME
       XmCreatePulldownMenu -- A RowColumn widget convenience creation function

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 (arglist).   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 disabled by the applica-
       tion.  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 CascadeButtonGadget 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 responsibility 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 OptionMenu, 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  XmVaCreateSimplePull-
       downMenu(3).

							       XmCreatePulldownMenu(library call)


All times are GMT -4. The time now is 04:07 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password