*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> XmArrowButtonGadget (3X)              
Title
Content
Arch
Section
 

XmArrowButtonGadget(3X)

Contents


NAME    [Toc]    [Back]

       XmArrowButtonGadget - The ArrowButtonGadget widget class

SYNOPSIS    [Toc]    [Back]

       #include <Xm/ArrowBG.h>


DESCRIPTION    [Toc]    [Back]

       ArrowButtonGadget  consists  of  a  directional arrow surrounded
 by a border  shadow.  When  it  is  selected,  the
       shadow  changes  to give the appearance that the ArrowButtonGadget
 has been pressed in.  When it is unselected, the
       shadow  reverts  to give the appearance that the button is
       released, or out.

   Classes    [Toc]    [Back]
       ArrowButtonGadget inherits  behavior  and  resources  from
       Object, RectObj, and XmGadget classes.

       The class pointer is xmArrowButtonGadgetClass.

       The class name is XmArrowButtonGadget.

   New Resources    [Toc]    [Back]
       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).

       ArrowButtonGadget Resource Set    [Toc]    [Back]

       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCArrowDirection
       Default: XmARROW_UP
       Type:  unsigned char
       Access: CSG
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCMultiClick
       Default: dynamic
       Type:  unsigned char
       Access: CSG

              Specifies  a  list of callbacks that is called when
              the ArrowButtonGadget is activated. To activate the
              button, press and release BSelect while the pointer
              is inside the  ArrowButtonGadget.   Activating  the
              ArrowButtonGadget  also disarms it. The reason sent
              by this callback  is  XmCR_ACTIVATE.   Specifies  a
              list of callbacks that is called when the ArrowButtonGadget
 is armed. To arm this widget, press  BSelect
  while  the pointer is inside the ArrowButtonGadget.
  The  reason  sent  by  this  callback   is
              XmCR_ARM.  Sets the arrow direction. The values for
              this  resource  are:   XmARROW_UP.    XmARROW_DOWN.
              XmARROW_LEFT.   XmARROW_RIGHT.  Specifies a list of
              callbacks that is called when the ArrowButtonGadget
              is  disarmed.  To  disarm  this  widget,  press and
              release BSelect while the  pointer  is  inside  the
              ArrowButtonGadget. The reason sent by this callback
              is XmCR_DISARM.  If a button click is  followed  by
              another button click within the time span specified
              by  the  display's  multi-click  time,   and   this
              resource  is  set  to  XmMULTICLICK_DISCARD, do not
              process the second click. If this resource  is  set
              to  XmMULTICLICK_KEEP, process the event and increment
 click_count in the  callback  structure.  When
              the ArrowButtonGadget is not in a menu, the default
              value is XmMULTICLICK_KEEP.

   Inherited Resources    [Toc]    [Back]
       ArrowButtonGadget inherits behavior and resources from the
       following superclasses. For a complete description of each
       resource, refer to the man page for that superclass.

       XmGadget Resource Set    [Toc]    [Back]

       Class: XmCBottomShadowColor
       Default: dynamic
       Type:  Pixel
       Access: G
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCHighlightColor
       Default: dynamic
       Type:  Pixel
       Access: G
       Class: XmCHighlightOnEnter
       Default: False
       Type:  Boolean
       Access: CSG
       Class: XmCHighlightThickness
       Default: 2
       Type:  Dimension
       Access: CSG
       Class: XmCNavigationType
       Default: XmNONE
       Type:  XmNavigationType
       Access: CSG
       Class: XmCShadowThickness
       Default: 2
       Type:  Dimension
       Access: CSG
       Class: XmCTopShadowColor
       Default: dynamic
       Type:  Pixel
       Access: G
       Class: XmCTraversalOn
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCUnitType
       Default: dynamic
       Type:  unsigned char
       Access: CSG
       Class: XmCUserData
       Default: NULL
       Type:  XtPointer
       Access: CSG


       RectObj Resource Set    [Toc]    [Back]

       Class: XmCSensitive
       Default: dynamic
       Type:  Boolean
       Access: G
       Class: XmCBorderWidth
       Default: 0
       Type:  Dimension
       Access: CSG
       Class: XmCHeight
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCSensitive
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCWidth
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCPosition
       Default: 0
       Type:  Position
       Access: CSG
       Class: XmCPosition
       Default: 0
       Type:  Position
       Access: CSG


       Object Resource Set    [Toc]    [Back]

       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C


   Callback Information    [Toc]    [Back]
       A pointer to the following structure  is  passed  to  each
       callback: typedef struct {
         int      reason;
         XEvent   * event;
         int      click_count; } XmArrowButtonCallbackStruct;

       Indicates  why  the  callback  was invoked.  Points to the
       XEvent that triggered the callback.  This value  is  valid
       only  when  the  reason  is XmCR_ACTIVATE. It contains the
       number of clicks in the last multiclick  sequence  if  the
       XmNmultiClick   resource   is  set  to  XmMULTICLICK_KEEP,
       otherwise it contains 1. The activate callback is  invoked
       for   each   click  if  XmNmultiClick  is  set  to  XmMULTICLICK_KEEP.


   Behavior    [Toc]    [Back]
       XmArrowButtonGadget includes behavior from XmGadget. Additional
  XmArrowButtonGadget  behavior  is described below:
       Draws the shadow in the selected state and calls the callbacks
  for  XmNarmCallback.  Draws the shadow in the unselected
 state. If the pointer is within the ArrowButtonGadget,
  calls  the  callbacks for XmNactivateCallback. Calls
       the callbacks for XmNdisarmCallback.  If XmNmultiClick  is
       XmMULTICLICK_DISCARD, this action does nothing. If XmNmultiClick
 is XmMULTICLICK_KEEP, this action draws the shadow
       in  the selected state and calls the callbacks for XmNarmCallback.
  If XmNmultiClick is XmMULTICLICK_DISCARD,  this
       action does nothing.

              If  XmNmultiClick is XmMULTICLICK_KEEP, this action
              does the following: Increments click_count  in  the
              callback  structure.  Draws the shadow in the unselected
 state. If the pointer is within  the  ArrowButtonGadget,
  calls the callbacks for XmNactivateCallback.
  Calls the callbacks  for  XmNdisarmCallback.
   Draws  the shadow in the selected state and
              calls the callbacks  for  XmNarmCallback.  Arranges
              for  the shadow to be drawn in the unselected state
              and  the  callbacks  for  XmNactivateCallback   and
              XmNdisarmCallback  to be called, either immediately
              or at a later time.  Calls the callbacks  for  XmNhelpCallback
  if  any  exist.  If there are no help
              callbacks for this  widget,  this  calls  the  help
              callbacks  for  the nearest ancestor that has them.
              Draws the ArrowButtonGadget shadow in its  selected
              state  if the pointer leaves and re-enters the gadget
 while BSelect is pressed.  Draws the  ArrowButtonGadget
  shadow  in  its  unselected state if the
              pointer leaves the gadget while BSelect is pressed.

   Virtual Bindings    [Toc]    [Back]
       The  bindings  for  virtual  keys are vendor specific. For
       information about bindings for virtual buttons  and  keys,
       see VirtualBindings(3X).

SEE ALSO    [Toc]    [Back]

      
      
       Object(3X),   RectObj(3X),  XmCreateArrowButtonGadget(3X),
       XmGadget(3X)



                                          XmArrowButtonGadget(3X)
[ Back ]
 Similar pages
Name OS Title
XmCreateArrowButtonGadget Tru64 The ArrowButtonGadget creation function
XmCreateArrowButtonGadget HP-UX The ArrowButtonGadget creation function
XmCreateArrowButtonGadget IRIX The ArrowButtonGadget creation function
Core Tru64 The Core widget class
tmsgipanel IRIX the SGI IconPanel widget class
tmsgithumbwheel IRIX the SGI sgThumbWheel widget class
tmlabel IRIX the Label widget class
tmspinbox IRIX the SpinBox widget class
tmtext IRIX the Text widget class
tmtogglebutton IRIX the ToggleButton widget class
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service