NAME

       XmPushButton — The PushButton widget class "XmPushButton" "widget class" "PushButton"

SYNOPSIS

       #include <Xm/PushB.h>

DESCRIPTION

       PushButton  issues  commands within an application.  It consists of a text label or pixmap
       surrounded by a border shadow.  When a PushButton is selected, the shadow changes to  give
       the  appearance  that  it has been pressed in. When a PushButton is unselected, the shadow
       changes to give the appearance that it is out.

       The default behavior associated with a PushButton in a menu depends on the  type  of  menu
       system  in  which it resides.  By default, <Btn1> controls the behavior of the PushButton.
       In addition, <Btn3> controls the behavior of the PushButton if it resides in  a  PopupMenu
       system.  The actual mouse button used is determined by its RowColumn parent.

       Thickness  for  a  second  shadow,  used when the PushButton is the default button, may be
       specified with the XmNshowAsDefault resource. If it  has  a  nonzero  value,  the  Label's
       resources XmNmarginLeft, XmNmarginRight, XmNmarginTop, and XmNmarginBottom may be modified
       to accommodate the second shadow.

       If an initial value  is  specified  for  XmNarmPixmap  but  not  for  XmNlabelPixmap,  the
       XmNarmPixmap value is used for XmNlabelPixmap.

       PushButton  uses  the  XmQTmenuSystem  and  XmQTspecifyRenderTable  traits,  and holds the
       XmQactivatable, XmQTmenuSavvy, and XmQTtakesDefault traits.

   Classes
       PushButton inherits behavior, resources, and traits from Core, XmPrimitive, and XmLabel.

       The class pointer is xmPushButtonWidgetClass.

       The class name is XmPushButton.

   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).

       ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
--

RELATED

       Core(3),    XmCreatePushButton(3),     XmLabel(3),     XmPrimitive(3),     XmRowColumn(3),
       XmVaCreatePushButton(3), and XmVaCreateManagedPushButton(3).

                                                                                  XmPushButton(3)