TcxCustomTrackBarProperties.PageSize Property
Specifies the amount by which the thumb’s position is changed when clicking the track bar or pressing the Page Up or Page Down key when the track bar editor is focused.
Declaration
property PageSize: TcxNaturalNumber read; write; default 2;
Property Value
Type | Default |
---|---|
TcxNaturalNumber | 2 |
Remarks
In a horizontally oriented editor (the Orientation property is set to tboHorizontal), end-users can change the Position property value using any of the following actions:
Pressing the Page Up key or clicking the track bar to the left of the thumb when the ThumbStep property is set to cxtsNormal decreases Position by the PageSize;
Pressing the Page Down key or clicking the bar to the right of the thumb when the ThumbStep property is set to cxtsNormal increases Position by the PageSize.
In a vertically oriented editor (the Orientation property is set to tboVertical), end-users can change the Position property value using any of the following actions:
Pressing the Page Up key or clicking the track bar above the thumb when the ThumbStep property is set to cxtsNormal decreases Position by the PageSize;
Pressing the Page Down key or clicking the bar below the thumb when the ThumbStep property is set to cxtsNormal increases Position by the PageSize.
Note that if the ReverseDirection property is set to True, the functionality provided by these keys switches to the opposite.
Tip
The range of values edited by the track bar is specified by the Min and Max properties. You can assign this range (or a greater value) to the PageSize property. In this case, pressing the Page Up key will result in moving the track bar’s thumb to the minimum available value independently of the current thumb’s position. Pressing the Page Down key will result in moving the track bar’s thumb to the maximum value available. Alternatively, the thumb can be moved in this manner by pressing the Home or End key, respectively.
In addition, end-users can move the thumb a small distance. Refer to the LineSize property description to learn more.
The default value of the PageSize property is 2.