This property defines the user's ability to select objects
in a graph and the operations that can be performed when one or
more objects are selected.
- When setSelectionEnable(1)
is used, the user can select individual objects (risers, markers,
labels, and so on) in a graph. The graphing engine highlights each object
that is selected.
- When setSelectionEnable(2)
is used, the user can only select data-related objects (bars, legends,
and so on). The graphing engine will highlight the selected data
objects and all related objects.
- When setSelectionEnable(3)
is used, the user cannot select individual objects. When one object
is selected, all related objects will also be selected and highlighted.
- When setSelectionEnable(4)
is used, the user can click on a single point and have the graph
zoom at the rate of 50% on both axes with the selected point used
as the center of the zoom rectangle.
- When setSelectionEnable(5)
is used, it allows the user to drag out a rectangle and zoom in
on the data within the rectangle area. When this mode is used, a
single mouse click will back up one data-zoom level. Double click
will restore the original zoomed data state. Note that user interface-based
zooming and scrolling is mutually exclusive with selecting graph
items. When setSelectionEnable(5) is used, graph objects cannot
be selected.
Syntax:
setSelectionEnable(value);
value = getSelectionEnable();
where:
- value
-
Can be one of the following:
0 for
no selection.
1 selects a single element,
only one object is highlighted.
2 selects
only data related objects (bar, legend) and select all related objects
when clicking on one.
3 selects all
related objects when one is clicked. 3 is the default value.
4 selects
50% data zooming on user-selected object.
5 selects
drill-down/data zooming mode.
See SelectionEnableMove.