xmcreatepulldownmenu(3) [redhat man page]
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 speci- fied 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 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 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 creat- ing 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 XmVaCreateSimplePulldownMenu(3). XmCreatePulldownMenu(library call)
Check Out this Related Man Page
XmCreateOptionMenu(library call) XmCreateOptionMenu(library call) NAME
XmCreateOptionMenu -- A RowColumn widget convenience creation function SYNOPSIS
#include <Xm/RowColumn.h> Widget XmCreateOptionMenu( Widget parent, String name, ArgList arglist, Cardinal argcount); DESCRIPTION
XmCreateOptionMenu creates an instance of a RowColumn widget of type XmMENU_OPTION and returns the associated widget ID. It is provided as a convenience function for creating a RowColumn widget configured to operate as an OptionMenu and is not implemented as a separate widget class. The OptionMenu widget is a specialized RowColumn manager composed of a label, a selection area, and a single Pulldown menu pane. When an application creates an OptionMenu widget, it supplies the label string and the Pulldown menu pane. In order for the operation to be suc- cessful, there must be a valid XmNsubMenuId resource set when this function is called. The LabelGadget and the selection area (a Cascade- ButtonGadget) are created by the OptionMenu. The OptionMenu's Pulldown menu pane must not contain any ToggleButtons or ToggleButtonGadgets. The results of including CascadeButtons or CascadeButtonGadgets in the OptionMenu's Pulldown menu pane are undefined. An OptionMenu is laid out with the label displayed on one side of the widget and the selection area on the other side when XmNorientation is XmHORIZONTAL. The layout of the label with respect to the selection area depends on the XmNlayoutDirection resource in the horizontal orientation. If the value is XmVERTICAL, the label is above the selection area. The selection area has a dual purpose; it displays the label of the last item selected from the associated Pulldown menu pane, and it provides the means for posting the Pulldown menu pane. The OptionMenu typically does not display any 3-D visuals around itself or the internal LabelGadget. By default, the internal CascadeBut- tonGadget has a visible 3-D shadow. The application may change this by getting the CascadeButtonGadget ID using XmOptionButtonGadget, and then calling XtSetValues using the standard visual-related resources. The Pulldown menu pane is posted when the mouse pointer is moved over the selection area and a mouse button that is defined by OptionMenu's RowColumn parent is pressed. The Pulldown menu pane is posted and positioned so that the last selected item is directly over the selection area. The mouse is then used to arm the desired menu item. When the mouse button is released, the armed menu item is selected and the label within the selection area is changed to match that of the selected item. By default, BSelect is used to interact with an OptionMenu. The default can be changed with the RowColumn resource XmNmenuPost. The OptionMenu also operates with the keyboard interface mechanism. If the application has established a mnemonic with the OptionMenu, pressing <Alt> with the mnemonic causes the Pulldown menu pane to be posted with traversal enabled. The standard traversal keys can then be used to move within the menu pane. Pressing <Return> or typing a mnemonic or accelerator for one of the menu items selects that item. An application may use the XmNmenuHistory resource to indicate which item in the Pulldown menu pane should be treated as the current choice and have its label displayed in the selection area. By default, the first selectable item in the Pulldown menu pane is used. 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) The user can specify resources in a resource file for the automatically created widgets and gadgets of an OptionMenu. These widgets (or gadgets) and the associated OptionMenu areas are Option Menu Label Gadget OptionLabel Option Menu Cascade Button OptionButton For a complete definition of RowColumn and its associated resources, see XmRowColumn(3). RETURN
Returns the RowColumn widget ID. RELATED
XmCascadeButtonGadget(3), XmCreatePulldownMenu(3), XmCreateSimpleOptionMenu(3), XmLabelGadget(3), XmOptionButtonGadget(3), XmOptionLabel- Gadget(3), XmRowColumn(3), and XmVaCreateSimpleOptionMenu(3). XmCreateOptionMenu(library call)