ChartDesigner.ChartStructureUpdating Event
Used to customize the Chart Designer Elements’ Tree.
Namespace: DevExpress.XtraCharts.Designer
Assembly: DevExpress.XtraCharts.v19.2.Wizard.dll
Declaration
Event Data
The ChartStructureUpdating event's data class is ChartStructureChangingEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| ChartModel | Returns the model of a chart whose structure starts changing. |
Remarks
You can use the ChartStructureUpdating event to perform the following tasks:
- Hide items. For example, disable the e.ChartModel.AnnotationRepository.ShowInStructureControl property to hide the Annotations item.
- Disable elements’ Add/Remove commands. For example, disable e.ChartModel.Series.AllowAddChild to prohibit adding new series and hide the Series item’s plus button.
- Prevent users from changing the chart element’s visibility. To do this, set the e.ChartModel.Series.AllowChangeVisibility property to false.
You cannot use this event to add custom options to the Chart Designer.
See Chart Designer for End Users for more information about Chart Designer customization.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ChartStructureUpdating event.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.