XUL Programmer's Reference Manual

<thumb/>

Attributes Common Children
id * * *
class  
curpos  
maxpos  
increment  
pageIncrement  
flex  
align  
The thumb is the moveable button in the scrollbar. Like scrollbar, thumb's attributes determine the position and rate of scrolling for the element. The following example shows a thumb defined within a scrollbar:
 
<scrollbar align="vertical" 
    curpos="50" 
    pageIncrement="20" 
    increment="5" 
    flex="100%">
  <scrollbarbutton type="decrement"/>
  <slider flex="100%">
     <thumb value="Thumb" flex="0%"/>
  </slider>
  <scrollbarbutton type="increment"/>
</scrollbar>


 

curpos
Description
curpos is a required attribute for specifying the position of the thumb button when it loads. The number is a number from 0 to maxpos
Syntax
<thumb curpos="number of pixels down from 0 to maxpos" />


Example

<thumb curpos="10" />


Notes

None.


 

maxpos
Description
maxpos is an optional attribute for specifying the total scrollable length of the scrollbar. 
Syntax
<thumb maxpos="number of pixels" />


Example

<scrollbar id="string" pageIncrement="XXX" />


Notes

maxpos and curpos relate with one another to determine the scrollable length and the position of the thumb.


 
 

increment
Description
increment is an optional attribute for specifying how much the position changes on each click of the scrollbarbuttons and slider area. 
Syntax
<thumb increment="number of pixels to scroll" />


Example

<thumb increment="5" />


Notes

The default value for increment is 1.

 
 
 
pageIncrement
Description
pageIncrement is an optional attribute for specifying the degree of position change when the user pages through the scrollbar. 
Syntax
<thumb pageIncrement="number of pixels to scroll on page" />


Example

<thumb pageIncrement="25" />


Notes

Using "Page Up" and "Page Down" pages through larger parts of a scrollable area according to the value specified for pageIncrement. See also increment for degrees of scrolling. The default pageIncrement value is 20.

 
 
 

 

Last updated: 13:10 1/26/00 Ian Oeschger