SAS/AF Software: Class Dictionary

Using the Scroll Bar Control

Key properties to set

Scrollbar Control: value (default attribute) Specify the position of the thumb within the scroll bar using a numeric value. For example, if the scrollbar is going to be used to denote the days of the week, then the value would be between 1 and 7.
You can also query or set this attribute using SCL. For example, the following line of SCL code sets the scroll bar value to 3:
scrollbar1.value = '3';

Note:   The following line of code is also valid since the value attribute is the default attribute:
scrollbar1 = '3';
   [cautionend]

The numeric value used may be dependent on the values set for the minimum and maximum attributes. See Setting minimum and maximum attributes for more details.

Scrollbar Control: orientation Specify whether you want the scroll bar oriented horizontally or vertically.
You can also query or set this attribute using SCL. For example, the following line of SCL code sets the scroll bar position to vertical:
scrollbar1.orientation = 'vertical';

Note:   The orientation attribute is a build-time attribute, meaning it can only be set at build-time.   [cautionend]

Setting minimum and maximum attributes

The minimum and maximum attributes control the numeric values associated with a scrollbar. For example, if your scrollbar represents the days of the week that a user can select, then the values would be 1 and 7, respectively.

Keep the following in mind when setting minimum and maximum attribute values:

the maximum value must always be greater than the minimum value
minimum and maximum attribute values must be changed using a specific order to avoid errors. If the new maximum value is going to be less than the current minimum value, then the new minimum value must be set first. If the new maximum value is going to be greater than the current minimum value, then set the new maximum value must be set first.
For example, suppose you want to change the current minimum and maximum attribute values from 100 and 200 to 300 and 400 (respectively). You would have to change the maximum attribute value first. If you attempted to change the minimum value first (from 100 to 300), an error would occur, since the minimum value would be greater than the maximum value.

Chapter Contents
Previous
Next
Top of Page