DataScrollerPresenceGroups

This property controls the presence of data scroller bars on the group axis. This property can be used for all 2D graphs except pies. It is not applicable for 3D graphs or 2D pie graphs. When the number of viewable groups is set to a value less than the number of groups in the data set, the scroller bar can be used to change the first group in the graph that is displayed (that is, it effectively changes the value assigned to ScrollOffsetGroup). The data scroller bar consists of two segments: 1) a segment that can be used to click and drag to the first group to be displayed and 2) a status bar that shows the number of the first group (for example, the ScrollOffsetGroup value), the total number of viewable groups, and the remaining number of groups in the data set. In the first segment, the darker, movable thumb can be dragged to change the group offset. In the second segment, the total of the three numbers indicates the total number of groups defined in the data set. For example, the status area of the scroll bar displays "2 3 1". These numbers indicate that ScrollOffsetGroup is "2", ViewableGroups is "3", there is "1" group in the data set that is not displayed, and there are a total of six groups defined in the data set. The user can click on these numbers and edit them with the arrow keys.

Syntax:

setDataScrollerPresenceGroups(value);
value = getDataScrollerPresenceGroups();

where:

value

Can be one of the following:

0 to never display data scroller bar. 0 is the default value.

1 to only display data scroller bar when ViewableGroups is greater than zero.

2 to always display data scroller bar.

Example:

setDepthRadius(0);
   setDataScrollerPresenceGroups(2);
setViewableGroups(4);

bar graph

See DataScrollerPresenceSeries, ScrollOffsetGroup, ViewableGroups.


WebFOCUS