Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages

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

XmCreateOptionMenu(library call)				 XmCreateOptionMenu(library call)

       XmCreateOptionMenu -- A RowColumn widget convenience creation function

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

       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
       successful, there must be a valid XmNsubMenuId resource set when this function is  called.
       The  LabelGadget and the selection area (a CascadeButtonGadget) are created by the Option-

       The OptionMenu's Pulldown menu pane must not contain any ToggleButtons or ToggleButtonGad-
       gets.  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 CascadeButtonGadget has a visible 3-D shadow.  The
       application may change this by getting the CascadeButtonGadget ID using XmOptionButtonGad-
       get, 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 Pull-
       down  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  inter-
       act  with  an OptionMenu.  The default can be changed with the RowColumn resource XmNmenu-

       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

       Option Menu Cascade Button

       For a complete definition of RowColumn and its associated resources, see XmRowColumn(3).

       Returns the RowColumn widget ID.

       XmCascadeButtonGadget(3), XmCreatePulldownMenu(3),  XmCreateSimpleOptionMenu(3),  XmLabel-
       Gadget(3),  XmOptionButtonGadget(3),  XmOptionLabelGadget(3), XmRowColumn(3), and XmVaCre-

								 XmCreateOptionMenu(library call)

All times are GMT -4. The time now is 11:30 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password