


XmScrollBar(3X)						      XmScrollBar(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSccrroollllBBaarr -	The ScrollBar widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//SSccrroollllBBaarr..hh>>

DESCRIPTION
  The ScrollBar	widget allows the user to view data that is too	large to be
  displayed all	at once.  ScrollBars are usually located inside	a Scrol-
  ledWindow and	adjacent to the	widget that contains the data to be viewed.
  When the user	interacts with the ScrollBar, the data within the other
  widget scrolls.

  A ScrollBar consists of two arrows placed at each end	of a rectangle.	 The
  rectangle is called the scroll region.  A smaller rectangle, called the
  slider, is placed within the scroll region.  The data	is scrolled by click-
  ing either arrow, selecting on the scroll region, or dragging	the slider.
  When an arrow	is selected, the slider	within the scroll region is moved in
  the direction	of the arrow by	an amount supplied by the application.	If
  the mouse button is held down, the slider continues to move at a constant
  rate.

  The ratio of the slider size to the scroll region size typically
  corresponds to the relationship between the size of the visible data and
  the total size of the	data.  For example, if 10 percent of the data is
  visible, the slider typically	occupies 10 percent of the scroll region.
  This provides	the user with a	visual clue to the size	of the invisible
  data.

  Classes

  ScrollBar inherits behavior and resources from the CCoorree and XXmmPPrriimmiittiivvee
  classes.

  The class pointer is xxmmSSccrroollllBBaarrWWiiddggeettCCllaassss.

  The class name is XXmmSSccrroollllBBaarr.

  New Resources

  The following	table defines a	set of widget resources	used by	the program-
  mer 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	XXmmNN or XXmmCC
  prefix and use the remaining letters.	 To specify one	of the defined values
  for a	resource in a .Xdefaults file, remove the XXmm prefix and	use the
  remaining letters (in	either lowercase or uppercase, but include any under-
  scores between words).  The codes in the access column indicate if the
  given	resource can be	set at creation	time (C), set by using XXttSSeettVVaalluueess
  (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable	(N/A).

			   XXmmSSccrroollllBBaarr RReessoouurrccee	SSeett
	 _____________________________________________________________
	 NNaammee				DDeeffaauulltt			AAcccceessss
	       CCllaassss			      TTyyppee
	 _____________________________________________________________
	 _____________________________________________________________
	 XmNdecrementCallback		NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNdragCallback		NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNincrement			1			CSG
	       XmCIncrement		       int
	 _____________________________________________________________
	 XmNincrementCallback		NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNinitialDelay		250 ms			CSG
	       XmCInitialDelay		       int
	 _____________________________________________________________
	 XmNmaximum			dynamic			CSG
	       XmCMaximum		       int
	 _____________________________________________________________
	 XmNminimum			0			CSG
	       XmCMinimum		       int
	 _____________________________________________________________
	 XmNorientation			XmVERTICAL		CSG
	       XmCOrientation		       unsigned	char
	 _____________________________________________________________
	 XmNpageDecrementCallback	NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNpageIncrement		10			CSG
	       XmCPageIncrement		       int
	 _____________________________________________________________
	 XmNpageIncrementCallback	NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNprocessingDirection		dynamic			CSG
	       XmCProcessingDirection	       unsigned	char
	 _____________________________________________________________
	 XmNrepeatDelay			50 ms			CSG
	       XmCRepeatDelay		       int
	 _____________________________________________________________
	 XmNshowArrows			True			CSG
	       XmCShowArrows		       Boolean
	 _____________________________________________________________
	 XmNsliderSize			dynamic			CSG
	       XmCSliderSize		       int
	 _____________________________________________________________
	 XmNtoBottomCallback		NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNtoTopCallback		NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________
	 XmNtroughColor			dynamic			CSG
	       XmCTroughColor		       Pixel
	 _____________________________________________________________
	 XmNvalue			dynamic			CSG
	       XmCValue			       int
	 _____________________________________________________________
	 XmNvalueChangedCallback	NULL			C
	       XmCCallback		       XtCallbackList
	 _____________________________________________________________

  XXmmNNddeeccrreemmeennttCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the ScrollBar by	one increment and the
	    value decreases.  The reason passed	to the callback	is
	    XXmmCCRR__DDEECCRREEMMEENNTT.

  XXmmNNddrraaggCCaallllbbaacckk
	    Specifies the list of callbacks that is called on each incremen-
	    tal	change of position when	the slider is being dragged.  The
	    reason sent	by the callback	is XXmmCCRR__DDRRAAGG.

  XXmmNNiinnccrreemmeenntt
	    Specifies the amount by which the value increases or decreases
	    when the user takes	an action that moves the slider	by one incre-
	    ment.  The actual change in	value is the lesser of XXmmNNiinnccrreemmeenntt
	    and	(previous XXmmNNvvaalluuee - XXmmNNmmiinniimmuumm) when the slider moves to the
	    end	of the ScrollBar with the minimum value, and the lesser
	    ofXXmmNNiinnccrreemmeenntt and (XXmmNNmmaaxxiimmuumm- XXmmNNsslliiddeerrSSiizzee - previous
	    XXmmNNvvaalluuee) when the slider moves to the end of the ScrollBar	with
	    the	maximum	value.	The value of this resource must	be greater
	    than 0.

  XXmmNNiinnccrreemmeennttCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the ScrollBar by	one increment and the
	    value increases.  The reason passed	to the callback	is
	    XXmmCCRR__IINNCCRREEMMEENNTT.

  XXmmNNiinniittiiaallDDeellaayy
	    Specifies the amount of time in milliseconds to wait before
	    starting continuous	slider movement	while a	button is pressed in
	    an arrow or	the scroll region.  The	value of this resource must
	    be greater than 0.

  XXmmNNmmaaxxiimmuumm
	    Specifies the slider's maximum value.  ScrollBars contained
	    within ScrolledWindows have	a maximum equal	to the size of
	    ScrollBar (that is,	the height if it is vertical, or the width if
	    it is horizontal).	XXmmNNmmaaxxiimmuumm must	be greater than	XXmmNNmmiinniimmuumm.

  XXmmNNmmiinniimmuumm
	    Specifies the slider's minimum value.  XXmmNNmmaaxxiimmuumm must be greater
	    than XXmmNNmmiinniimmuumm.

  XXmmNNoorriieennttaattiioonn
	    Specifies whether the ScrollBar is displayed vertically or hor-
	    izontally.	This resource can have values of XXmmVVEERRTTIICCAALL and
	    XXmmHHOORRIIZZOONNTTAALL.

  XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the ScrollBar by	one page increment
	    and	the value decreases.  The reason passed	to the callback	is
	    XXmmCCRR__PPAAGGEE__DDEECCRREEMMEENNTT.

  XXmmNNppaaggeeIInnccrreemmeenntt
	    Specifies the amount by which the value increases or decreases
	    when the user takes	an action that moves the slider	by one page
	    increment.	The actual change in value is the lesser of
	    XXmmNNppaaggeeIInnccrreemmeenntt and (previous XXmmNNvvaalluuee - XXmmNNmmiinniimmuumm) when the
	    slider moves to the	end of the ScrollBar with the minimum value,
	    and	the lesser of XXmmNNppaaggeeIInnccrreemmeenntt and (XXmmNNmmaaxxiimmuumm-	XXmmNNsslliiddeerr--
	    SSiizzee - previous XXmmNNvvaalluuee) when the slider moves to the end of the
	    ScrollBar with the maximum value.  The value of this resource
	    must be greater than 0.






  XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the ScrollBar by	one page increment
	    and	the value increases.  The reason passed	to the callback	is
	    XXmmCCRR__PPAAGGEE__IINNCCRREEMMEENNTT.

  XXmmNNpprroocceessssiinnggDDiirreeccttiioonn
	    Specifies whether the value	for XXmmNNmmaaxxiimmuumm should be on the	right
	    or left side of XXmmNNmmiinniimmuumm for horizontal ScrollBars or above or
	    below XXmmNNmmiinniimmuumm for vertical ScrollBars.  This resource can have
	    values of XXmmMMAAXX__OONN__TTOOPP,, XXmmMMAAXX__OONN__BBOOTTTTOOMM,,XXmmMMAAXX__OONN__LLEEFFTT, and
	    XXmmMMAAXX__OONN__RRIIGGHHTT.  If	the XmScrollBar	is oriented vertically,	the
	    default value is XXmmMMAAXX__OONN__BBOOTTTTOOMM.  If the XmScrollBar is oriented
	    horizontally, the default value may	depend on the value of the
	    XXmmNNssttrriinnggDDiirreeccttiioonn resource.

  XXmmNNrreeppeeaattDDeellaayy
	    Specifies the amount of time in milliseconds to wait between sub-
	    sequent slider movements after the XXmmNNiinniittiiaallDDeellaayy has been	pro-
	    cessed.  The value of this resource	must be	greater	than 0.

  XXmmNNsshhoowwAArrrroowwss
	    Specifies whether the arrows are displayed.

  XXmmNNsslliiddeerrSSiizzee
	    Specifies the length of the	slider between the values of 1 and
	    (XXmmNNmmaaxxiimmuumm	- XXmmNNmmiinniimmuumm).	The value is constrained to be within
	    these inclusive bounds.  The default value is (XXmmNNmmaaxxiimmuumm -
	    XXmmNNmmiinniimmuumm)	divided	by 10, with a minimum of 1.

  XXmmNNttooBBoottttoommCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the slider to the end of	the ScrollBar
	    with the maximum value.  The reason	passed to the callback is
	    XXmmCCRR__TTOO__BBOOTTTTOOMM.

  XXmmNNttooTTooppCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the user
	    takes an action that moves the slider to the end of	the ScrollBar
	    with the minimum value.  The reason	passed to the callback is
	    XXmmCCRR__TTOO__TTOOPP.

  XXmmNNttrroouugghhCCoolloorr
	    Specifies the color	of the slider trough.

  XXmmNNvvaalluuee  Specifies the slider's position, between XXmmNNmmiinniimmuumm	and (XXmmNNmmaaxx--
	    iimmuumm - XXmmNNsslliiddeerrSSiizzee).  The	value is constrained to	be within
	    these inclusive bounds.  The initial value of this resource	is
	    the	larger of 0 and	XXmmNNmmiinniimmuumm.

  XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    Specifies the list of callbacks that is called when	the slider is
	    released after being dragged.  These callbacks are also called in
	    place of XXmmNNiinnccrreemmeennttCCaallllbbaacckk, XXmmNNddeeccrreemmeennttCCaallllbbaacckk, XXmmNNppaaggeeIInn--
	    ccrreemmeennttCCaallllbbaacckk, XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk, XXmmNNttooTTooppCCaallllbbaacckk, or
	    XXmmNNttooBBoottttoommCCaallllbbaacckk	when one of these callback lists would nor-
	    mally be called but	the value of the corresponding resource	is
	    NULL.  The reason passed to	the callback is	XXmmCCRR__VVAALLUUEE__CCHHAANNGGEEDD.

  Inherited Resources

  ScrollBar inherits behavior and resources from the following superclasses.
  For a	complete description of	each resource, refer to	the man	page for that
  superclass.

			   XXmmPPrriimmiittiivvee RReessoouurrccee	SSeett
	______________________________________________________________
	NNaammee			      DDeeffaauulltt			AAcccceessss
	      CCllaassss			    TTyyppee
	______________________________________________________________
	______________________________________________________________
	XmNbottomShadowColor	      dynamic			CSG
	      XmCBottomShadowColor	     Pixel
	______________________________________________________________
	XmNbottomShadowPixmap	      XmUNSPECIFIED_PIXMAP	CSG
	      XmCBottomShadowPixmap	     Pixmap
	______________________________________________________________
	XmNforeground		      dynamic			CSG
	      XmCForeground		     Pixel
	______________________________________________________________
	XmNhelpCallback		      NULL			C
	      XmCCallback		     XtCallbackList
	______________________________________________________________
	XmNhighlightColor	      dynamic			CSG
	      XmCHighlightColor		     Pixel
	______________________________________________________________
	XmNhighlightOnEnter	      False			CSG
	      XmCHighlightOnEnter	     Boolean
	______________________________________________________________
	XmNhighlightPixmap	      dynamic			CSG
	      XmCHighlightPixmap	     Pixmap
	______________________________________________________________
	XmNhighlightThickness	      dynamic			CSG
	      XmCHighlightThickness	     Dimension
	______________________________________________________________
	XmNnavigationType	      XmSTICKY_TAB_GROUP	CSG
	      XmCNavigationType		     XmNavigationType
	______________________________________________________________
	XmNshadowThickness	      2				CSG
	      XmCShadowThickness	     Dimension
	______________________________________________________________
	XmNtopShadowColor	      dynamic			CSG
	      XmCTopShadowColor		     Pixel
	______________________________________________________________
	XmNtopShadowPixmap	      dynamic			CSG
	      XmCTopShadowPixmap	     Pixmap
	______________________________________________________________
	XmNtraversalOn		      dynamic			CSG
	      XmCTraversalOn		     Boolean
	______________________________________________________________
	XmNunitType		      dynamic			CSG
	      XmCUnitType		     unsigned char
	______________________________________________________________
	XmNuserData		      NULL			CSG
	      XmCUserData		     XtPointer
	______________________________________________________________

			      CCoorree RReessoouurrccee SSeett
     ____________________________________________________________________
     NNaammee				   DDeeffaauulltt		   AAcccceessss
	   CCllaassss				 TTyyppee
     ____________________________________________________________________
     ____________________________________________________________________
     XmNaccelerators			   dynamic		   CSG
	   XmCAccelerators			  XtAccelerators
     ____________________________________________________________________
     XmNancestorSensitive		   dynamic		   G
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNbackground			   dynamic		   CSG
	   XmCBackground			  Pixel
     ____________________________________________________________________
     XmNbackgroundPixmap		   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderColor			   XtDefaultForeground	   CSG
	   XmCBorderColor			  Pixel
     ____________________________________________________________________
     XmNborderPixmap			   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderWidth			   0			   CSG
	   XmCBorderWidth			  Dimension
     ____________________________________________________________________
     XmNcolormap			   dynamic		   CG
	   XmCColormap				  Colormap
     ____________________________________________________________________
     XmNdepth				   dynamic		   CG
	   XmCDepth				  int
     ____________________________________________________________________
     XmNdestroyCallback			   NULL			   C
	   XmCCallback				  XtCallbackList
     ____________________________________________________________________
     XmNheight				   dynamic		   CSG
	   XmCHeight				  Dimension
     ____________________________________________________________________
     XmNinitialResourcesPersistent	   True			   C
	   XmCInitialResourcesPersistent	  Boolean
     ____________________________________________________________________
     XmNmappedWhenManaged		   True			   CSG
	   XmCMappedWhenManaged			  Boolean
     ____________________________________________________________________
     XmNscreen				   dynamic		   CG
	   XmCScreen				  Screen *
     ____________________________________________________________________
     XmNsensitive			   True			   CSG
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNtranslations			   dynamic		   CSG
	   XmCTranslations			  XtTranslations
     ____________________________________________________________________
     XmNwidth				   dynamic		   CSG
	   XmCWidth				  Dimension
     ____________________________________________________________________
     XmNx				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________
     XmNy				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________

  Callback Information

  A pointer to the following structure is passed to each callback:


  ttyyppeeddeeff ssttrruucctt
  {{
    iinntt	     _r_e_a_s_o_n;;
    XXEEvveenntt   * _e_v_e_n_t;;
    iinntt	     _v_a_l_u_e;;
    iinntt	     _p_i_x_e_l;;
  }} XXmmSSccrroollllBBaarrCCaallllbbaacckkSSttrruucctt;;

  _r_e_a_s_o_n Indicates why the callback was	invoked.

  _e_v_e_n_t	 Points	to the XXEEvveenntt that triggered the callback.

  _v_a_l_u_e	 Contains the new slider location value.

  _p_i_x_e_l	 Is used only for XXmmNNttooTTooppCCaallllbbaacckk and XXmmNNttooBBoottttoommCCaallllbbaacckk.  For hor-
	 izontal ScrollBars, it	contains the _x coordinate of where the mouse
	 button	selection occurred.  For vertical ScrollBars, it contains the
	 _y coordinate.

  Translations

  XmScrollBar includes translations from Primitive.  The XmScrollBar transla-
  tions	are listed below.  These translations may not directly correspond to
  a translation	table.

       BBSSeelleecctt PPrreessss:: SSeelleecctt(())
       BBSSeelleecctt RReelleeaassee::RReelleeaassee(())
       BBSSeelleecctt PPrreessss MMoovveedd::MMoovveedd(())
       BBDDrraagg PPrreessss::   SSeelleecctt(())
       BBDDrraagg RReelleeaassee:: RReelleeaassee(())
       BBDDrraagg PPrreessss MMoovveedd::MMoovveedd(())
       MMCCttrrll BBSSeelleecctt PPrreessss::TTooppOOrrBBoottttoomm(())
       MMCCttrrll BBSSeelleecctt RReelleeaassee::RReelleeaassee(())
       KKUUpp::	      IInnccrreemmeennttUUppOOrrLLeefftt((00))
       MMCCttrrll KKUUpp::     PPaaggeeUUppOOrrLLeefftt((00))
       KKDDoowwnn::	      IInnccrreemmeennttDDoowwnnOOrrRRiigghhtt((00))
       MMCCttrrll KKDDoowwnn::   PPaaggeeDDoowwnnOOrrRRiigghhtt((00))
       KKLLeefftt::	      IInnccrreemmeennttUUppOOrrLLeefftt((11))
       MMCCttrrll KKLLeefftt::   PPaaggeeUUppOOrrLLeefftt((11))
       KKRRiigghhtt::	      IInnccrreemmeennttDDoowwnnOOrrRRiigghhtt((11))
       MMCCttrrll KKRRiigghhtt::  PPaaggeeDDoowwnnOOrrRRiigghhtt((11))
       KKPPaaggeeUUpp::	      PPaaggeeUUppOOrrLLeefftt((00))
       KKPPaaggeeDDoowwnn::     PPaaggeeDDoowwnnOOrrRRiigghhtt((00))
       KKPPaaggeeLLeefftt::     PPaaggeeUUppOOrrLLeefftt((11))
       KKPPaaggeeRRiigghhtt::    PPaaggeeDDoowwnnOOrrRRiigghhtt((11))
       KKBBeeggiinnLLiinnee::    TTooppOOrrBBoottttoomm(())
       KKEEnnddLLiinnee::      TTooppOOrrBBoottttoomm(())
       KKBBeeggiinnDDaattaa::    TTooppOOrrBBoottttoomm(())
       KKEEnnddDDaattaa::      TTooppOOrrBBoottttoomm(())
       KKNNeexxttFFiieelldd::    PPrriimmiittiivveeNNeexxttTTaabbGGrroouupp(())
       KKPPrreevvFFiieelldd::    PPrriimmiittiivveePPrreevvTTaabbGGrroouupp(())
       KKAAccttiivvaattee::     PPrriimmiittiivveePPaarreennttAAccttiivvaattee(())
       KKCCaanncceell::	      CCaanncceellDDrraagg(())
       KKHHeellpp::	      PPrriimmiittiivveeHHeellpp(())

  Action Routines

  The ScrollBar	action routines	are described below:

  CCaanncceellDDrraagg(()):
	    If the key press occurs during scrolling, cancels the scroll and
	    returns the	slider to its previous location	in the scrollbar,
	    otherwise, and if the parent is a manager, it passes the event to
	    the	parent.

  IInnccrreemmeennttDDoowwnnOOrrRRiigghhtt((00||11)):
	    With an argument of	0, moves the slider down by one	increment.
	    With an argument of	1, moves the slider right by one increment.
	    If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__RRIIGGHHTT	or XXmmMMAAXX__OONN__BBOOTTTTOOMM,
	    movement toward the	right or bottom	calls the callbacks for
	    XXmmNNiinnccrreemmeennttCCaallllbbaacckk.  If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is	XXmmMMAAXX__OONN__LLEEFFTT
	    or XXmmMMAAXX__OONN__TTOOPP, movement toward the right or bottom calls the
	    callbacks for XXmmNNddeeccrreemmeennttCCaallllbbaacckk.	 The XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    is called if the XXmmNNiinnccrreemmeennttCCaallllbbaacckk or XXmmNNddeeccrreemmeennttCCaallllbbaacckk is
	    NULL.

  IInnccrreemmeennttUUppOOrrLLeefftt((00||11)):
	    With an argument of	0, moves the slider up by one increment.
	    With an argument of	1, moves the slider left by one	increment.
	    If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__RRIIGGHHTT	or XXmmMMAAXX__OONN__BBOOTTTTOOMM,
	    movement to	the left or top	calls the callbacks for	XXmmNNddeeccrreemmeenntt--
	    CCaallllbbaacckk.  If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__LLEEFFTT or
	    XXmmMMAAXX__OONN__TTOOPP, movement to the left or top calls the	callbacks for
	    XXmmNNiinnccrreemmeennttCCaallllbbaacckk.  The XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk is called if
	    the	XXmmNNiinnccrreemmeennttCCaallllbbaacckk or	XXmmNNddeeccrreemmeennttCCaallllbbaacckk is	NULL.

  MMoovveedd(()):  If the button press	occurs within the slider, the subsequent
	    motion events move the slider to the position of the pointer and
	    call the callbacks for XXmmNNddrraaggCCaallllbbaacckk.

  PPaaggeeDDoowwnnOOrrRRiigghhtt((00||11)):
	    With an argument of	0, moves the slider down by one	page incre-
	    ment.  With	an argument of 1, moves	the slider right by one	page
	    increment.	If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__RRIIGGHHTT or
	    XXmmMMAAXX__OONN__BBOOTTTTOOMM, movement toward the right or bottom calls the
	    callbacks for XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk.  If	XXmmNNpprroocceessssiinnggDDiirreecc--
	    ttiioonn is XXmmMMAAXX__OONN__LLEEFFTT or XXmmMMAAXX__OONN__TTOOPP, movement toward the right
	    or bottom calls the	callbacks for XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk.	 The
	    XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk is called if the XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk
	    or XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk	is NULL.

  PPaaggeeUUppOOrrLLeefftt((00||11)):
	    With an argument of	0, moves the slider up by one page increment.
	    With an argument of	1, moves the slider left by one	page incre-
	    ment.  If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is	XXmmMMAAXX__OONN__RRIIGGHHTT or
	    XXmmMMAAXX__OONN__BBOOTTTTOOMM, movement to the left or top calls the callbacks
	    for	XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk.  If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is
	    XXmmMMAAXX__OONN__LLEEFFTT or XXmmMMAAXX__OONN__TTOOPP, movement to the left	or top calls
	    the	callbacks for XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk.	 The XXmmNNvvaalluueeCChhaannggeedd--
	    CCaallllbbaacckk is	called if the XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk or XXmmNNppaaggeeDDee--
	    ccrreemmeennttCCaallllbbaacckk is NULL.

  PPrriimmiittiivveeHHeellpp(()):
	    Calls the callbacks	for XXmmNNhheellppCCaallllbbaacckk if any exist. If there
	    are	no help	callbacks for this widget, this	action calls the help
	    callbacks for the nearest ancestor that has	them.

  PPrriimmiittiivveeNNeexxttTTaabbGGrroouupp(()):
	    Traverses to the first item	in the next tab	group.	If the
	    current tab	group is the last entry	in the tab group list, it
	    wraps to the beginning of the tab group list.

  PPrriimmiittiivveePPaarreennttAAccttiivvaattee(()):
	    If the parent is a manager,	passes the event to the	parent.

  PPrriimmiittiivveePPrreevvTTaabbGGrroouupp(()):
	    Traverses to the first item	in the previous	tab group.  If the
	    beginning of the tab group list is reached,	it wraps to the	end
	    of the tab group list.

  RReelleeaassee(()):
	    If the button press	occurs within the slider and the slider	posi-
	    tion is changed, the callbacks for XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk are
	    called.

  SSeelleecctt(()): In the arrow:  Moves the slider by one increment in	the direction
	    of the arrow.  If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is	XXmmMMAAXX__OONN__RRIIGGHHTT or
	    XXmmMMAAXX__OONN__BBOOTTTTOOMM, movement toward the right or bottom calls the
	    callbacks for XXmmNNiinnccrreemmeennttCCaallllbbaacckk,	and movement to	the left or
	    top	calls the callbacks for	XXmmNNddeeccrreemmeennttCCaallllbbaacckk.  If XXmmNNpprroocceess--
	    ssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__LLEEFFTT or XXmmMMAAXX__OONN__TTOOPP, movement toward
	    the	right or bottom	calls the callbacks for	XXmmNNddeeccrreemmeennttCCaallllbbaacckk,
	    and	movement to the	left or	top calls the callbacks	for
	    XXmmNNiinnccrreemmeennttCCaallllbbaacckk.  The XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk is called if
	    the	XXmmNNiinnccrreemmeennttCCaallllbbaacckk or	XXmmNNddeeccrreemmeennttCCaallllbbaacckk is	NULL.

	    In the scroll region between an arrow and the slider:  Moves the
	    slider by one page increment in the	direction of the arrow.	 If
	    XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__RRIIGGHHTT or	XXmmMMAAXX__OONN__BBOOTTTTOOMM,
	    movement toward the	right or bottom	calls the callbacks for
	    XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk, and movement to the left or top calls
	    the	callbacks for XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk.	 If XXmmNNpprroocceessssiinngg--
	    DDiirreeccttiioonn is XXmmMMAAXX__OONN__LLEEFFTT or XXmmMMAAXX__OONN__TTOOPP,	movement toward	the
	    right or bottom calls the callbacks	for XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk,
	    and	movement to the	left or	top calls the callbacks	for
	    XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk.  The XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk is called
	    if the XXmmNNppaaggeeIInnccrreemmeennttCCaallllbbaacckk or XXmmNNppaaggeeDDeeccrreemmeennttCCaallllbbaacckk	is
	    NULL.

	    In the slider:  Activates the interactive dragging of the slider.

	    If the button is held down in either the arrows or the scroll
	    region longer than the XXmmNNiinniittiiaallDDeellaayy resource, the slider	is
	    moved again	by the same increment and the same callbacks are
	    called.  After the initial delay has been used, the	time delay
	    changes to the time	defined	by the resource	XXmmNNrreeppeeaattDDeellaayy.

  TTooppOOrrBBoottttoomm(()):
	    MMCCttrrll BBSSeelleecctt PPrreessss	in an arrow or in the scroll region between
	    an arrow and the slider moves the slider as	far as possible	in
	    the	direction of the arrow.	 If XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is
	    XXmmMMAAXX__OONN__RRIIGGHHTT or XXmmMMAAXX__OONN__BBOOTTTTOOMM, movement	toward the right or
	    bottom calls the callbacks for XXmmNNttooBBoottttoommCCaallllbbaacckk,	and movement
	    to the left	or top calls the callbacks for XXmmNNttooTTooppCCaallllbbaacckk.  If
	    XXmmNNpprroocceessssiinnggDDiirreeccttiioonn is XXmmMMAAXX__OONN__LLEEFFTT or XXmmMMAAXX__OONN__TTOOPP, movement
	    toward the right or	bottom calls the callbacks for XXmmNNttooTTooppCCaallll--
	    bbaacckk, and movement to the left or top calls	the callbacks for
	    XXmmNNttooBBoottttoommCCaallllbbaacckk.  The XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk is called	if
	    the	XXmmNNttooTTooppCCaallllbbaacckk or XXmmNNttooBBoottttoommCCaallllbbaacckk	is NULL.  Pressing
	    KKBBeeggiinnLLiinnee or KKBBeeggiinnDDaattaa moves the slider to the minimum value
	    and	invokes	the XXmmNNttooTTooppCCaallllbbaacckk.  Pressing	KKEEnnddLLiinnee or KKEEnnddDDaattaa
	    moves the slider to	the maximum value and invokes the XXmmNNttooBBoott--
	    ttoommCCaallllbbaacckk.

  Virtual Bindings

  The bindings for virtual keys	are vendor specific.  For information about
  bindings for virtual buttons and keys, see VViirrttuuaallBBiinnddiinnggss((33XX)).

RELATED	INFORMATION
  CCoorree((33XX)), XXmmCCrreeaatteeSSccrroollllBBaarr((33XX)), XXmmPPrriimmiittiivvee((33XX)), XXmmSSccrroollllBBaarrGGeettVVaalluueess((33XX)),
  and XXmmSSccrroollllBBaarrSSeettVVaalluueess((33XX)).

















