Specifications
Athena Widget Set libXaw 1.0.7
thumb This pixmap is used to tile (or stipple) the thumb of the scrollbar.Ifno
tiling is desired, then set this resource to None.This resource will accept
either a bitmap or a pixmap that is the same depth as the window. The
resource converter for this resource constructs bitmaps from the contents
of files. (See Converting Bitmaps for details.)
topOfThumb The location of the top of the thumb, as a percentage (0.0 - 1.0) of the
length of the scrollbar.This resource was called top in previous versions
of the Athena widget set. The name collided with the a Form widget
constraint resource, and had to be changed.
translations The ev e nt bindings associated with this widget.
x
yThe location of the upper left outside corner of this widget in its parent.
3.7.2. Scrollbar Actions
The actions supported by the Scrollbar widget are:
StartScroll(value)The possible values are Forward, Backward, or Continuous. This must
be the first action to begin a newmovement.
NotifyScroll(value)The possible values are Proportional or FullLength. If the argument to
StartScroll was Forward or Backward, NotifyScroll executes the scroll-
Proc callbacks and passes either; the position of the pointer,if value is
Proportional, or the full length of the scroll bar,if value is FullLength. If
the argument to StartScroll was Continuous, NotifyScroll returns without
executing anycallbacks.
EndScroll() This must be the last action after a movement is complete.
MoveThumb() Repositions the Scrollbar’sthumb to the current pointer location.
NotifyThumb() Calls the jumpProc callbacks and passes the relative position of the
pointer as a percentage of the scroll bar length.
The default bindings for Scrollbar are:
<Btn1Down>: StartScroll(Forward)
<Btn2Down>: StartScroll(Continuous) MoveThumb( ) NotifyThumb( )
<Btn3Down>: StartScroll(Backward)
<Btn2Motion>: MoveThumb( ) NotifyThumb( )
<BtnUp>: NotifyScroll(Proportional) EndScroll( )
Examples of additional bindings a user might wish to specify in a resource file are:
*Scrollbar.Translations: \
˜Meta<Key>space: StartScroll(Forward) NotifyScroll(FullLength) \n\
Meta<Key>space: StartScroll(Backward) NotifyScroll(FullLength) \n\
EndScroll( )
3.7.3. Scrollbar Callbacks
There are twocallback lists provided by the Scrollbar widget. The procedural interface for these
functions is described here.
The calling interface to the scrollProc callback procedure is:
44