Provided by: libmotif-dev_2.3.3-5ubuntu1_amd64 bug


       XmCascadeButton — The CascadeButton widget class


       #include <Xm/CascadeB.h>


       CascadeButton links two menu panes or a MenuBar to a menu pane.

       It  is  used  in  menu  systems and must have a RowColumn parent with its XmNrowColumnType
       resource set to XmMENU_BAR, XmMENU_POPUP or XmMENU_PULLDOWN.

       It is the only widget that can have a Pulldown menu pane attached to it as a submenu.  The
       submenu  is  displayed  when  this widget is activated within a MenuBar, a PopupMenu, or a
       PulldownMenu. Its visuals can include a label or pixmap and a cascading indicator when  it
       is in a Popup or Pulldown menu pane; or it can include only a label or a pixmap when it is
       in a MenuBar.  The positioning of the  PulldownMenu  with  respect  to  the  CascadeButton
       depends on the XmNlayoutDirection resource of the MenuShell.

       The default behavior associated with a CascadeButton depends on the type of menu system in
       which it resides.  By default, BSelect controls the behavior  of  the  CascadeButton.   In
       addition,  BMenu  controls  the behavior of the CascadeButton if it resides in a PopupMenu
       system.  The actual mouse button used is determined by its RowColumn parent.   BMenu  also
       performs the BSelect actions in all types of menu systems.

       A  CascadeButton's  visuals differ from most other button gadgets. When the button becomes
       armed, its visuals change from a 2-D to a 3-D look, and it displays the submenu  that  has
       been attached to it. If no submenu is attached, it simply changes its visuals.

       When  a  CascadeButton  within a Pulldown or Popup menu pane is armed as the result of the
       user moving the mouse pointer into  the  widget,  it  does  not  immediately  display  its
       submenu. Instead, it waits a short amount of time to see if the arming was temporary (that
       is, the user was simply passing through the widget), or whether the user really wanted the
       submenu posted. This time delay is configurable using XmNmappingDelay.

       CascadeButton  provides  a  single  mechanism for activating the widget from the keyboard.
       This mechanism is referred to as a keyboard mnemonic.  If a mnemonic  has  been  specified
       for  the  widget,  the  user  may activate the CascadeButton by simply typing the mnemonic
       while the CascadeButton is visible.  If the CascadeButton is in a MenuBar and the  MenuBar
       does  not  have the focus, the MAlt modifier must be pressed with the mnemonic.  Mnemonics
       are typically used to interact with a menu using the keyboard interface.

       If the Cascadebutton is in a Pulldown or Popup menu pane and there is a submenu  attached,
       the XmNmarginBottom, XmNmarginLeft, XmNmarginRight, and XmNmarginTop resources may enlarge
       to accommodate XmNcascadePixmap.  XmNmarginWidth defaults to 6 if this resource  is  in  a
       MenuBar; otherwise, it takes Label's default, which is 2.

       CascadeButton uses the XmQTmenuSystem and XmQTspecifyRenderTable traits.

       CascadeButton inherits behavior, resources, and traits from Core, XmPrimitive, and XmLabel

       The class pointer is xmCascadeButtonWidgetClass.

       The class name is XmCascadeButton.

   New Resources
       The following table defines a set of widget resources used by the  programmer  to  specify
       data.  The  programmer  can  also set the resource values for the inherited classes to set
       attributes for this widget. To reference a resource by name or by class  in  a  .Xdefaults
       file,  remove  the  XmN or XmC prefix and use the remaining letters. To specify one of the
       defined values for a resource in a .Xdefaults file, remove  the  Xm  prefix  and  use  the
       remaining  letters  (in either lowercase or uppercase, but include any underscores between
       words).  The codes in the access column indicate if the  given  resource  can  be  set  at
       creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
       not applicable (N/A).

Binary file (standard input) matches