NAME

       XmPushButtonGadget   —   The   PushButtonGadget   widget   class   "XmPushButtonGadget"   "widget  class"
       "PushButtonGadget"

SYNOPSIS

       #include <Xm/PushBG.h>

DESCRIPTION

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

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

       Thickness  for  a  second shadow may be specified with the XmNshowAsDefault resource. If it has a nonzero
       value, the Label's XmNmarginLeft, XmNmarginRight, XmNmarginTop,  and  XmNmarginBottom  resources  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.

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

   Classes
       PushButtonGadget  inherits  behavior,  resources,  and  traits  from  Object,   RectObj,   XmGadget   and
       XmLabelGadget.

       The class pointer is xmPushButtonGadgetClass.

       The class name is XmPushButtonGadget.

   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

       Object(3),   RectObj(3),   XmCreatePushButtonGadget(3),  XmGadget(3),  XmLabelGadget(3),  XmRowColumn(3),
       XmVaCreatePushButtonGadget(3), and XmVaCreateManagedPushButtonGadget(3).

                                                                                           XmPushButtonGadget(3)