TcxGridChartDiagram.Active Property

Specifies whether the chart diagram is visible within a Chart View.

Declaration

property Active: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

Set the Active property to True to make a chart diagram active and visible within a Chart View. Since only one chart diagram can be displayed at a time if any other chart diagram is active when this method is called it will be inactivated (its Active property is set to False) and the chart diagram for which this property is set will be activated and made visible within the View.

Note

A chart diagram cannot be activated once it’s been disabled (its Enabled property has been set to False). The Active property’s value of the currently active chart diagram cannot be changed directly by setting this property to False. One of the possible ways to hide the currently active chart diagram from the View is to activate another diagram. The other way is to set the currently active diagram’s Enabled property to False. As a result, one of the diagrams available for displaying (which is enabled) will be activated. If all diagrams are disabled, nothing will be displayed within the View in this case.

To activate a specific diagram, set the View’s ActiveDiagram property.

Once the active diagram has been changed, the View’s OnActiveDiagramChanged event is fired.

The default value of the Active property is False.