large_change() [1/2]

virtual int32 xtd::forms::scroll_bar::large_change ( ) const

virtualnoexcept

Gets a value to be added to or subtracted from the xtd::forms::scroll_bar::value property when the scroll box is moved a large distance.

Returns

A numeric value. The default value is 10.

Exceptions

xtd::argument_out_of_range_exception

The assigned value is less than 0.

Remarks

When the user clicks in the scroll bar track on either side of the scroll box, the xtd::forms::scroll_bar::value property changes according to the value set in the xtd::forms::scroll_bar::large_change property.

Note

You can handle key press events so that when the user presses the PAGE UP or PAGE DOWN key the scroll box moves.

Remarks

User interface guidelines suggest that the xtd::forms::scroll_bar::small_change and xtd::forms::scroll_bar::large_change properties are set relative to the size of the view that the user sees, not to the total size including the unseen part. For example, if you have a picture box with scroll bars displaying a large image, the xtd::forms::scroll_bar::small_change and xtd::forms::scroll_bar::large_change properties should be set relative to the size of the picture box, not to the size of the image.