Back to Devexpress

ChartDesigner.ChartStructureUpdating Event

windowsforms-devexpress-dot-xtracharts-dot-designer-dot-chartdesigner-4667bf5e.md

latest2.5 KB
Original Source

ChartDesigner.ChartStructureUpdating Event

Used to customize the Chart Designer Elements’ Tree.

Namespace : DevExpress.XtraCharts.Designer

Assembly : DevExpress.XtraCharts.v25.2.Wizard.dll

NuGet Package : DevExpress.Win.Charts

Declaration

csharp
public event ChartStructureUpdatingEventHandler ChartStructureUpdating
vb
Public Event ChartStructureUpdating As ChartStructureUpdatingEventHandler

Event Data

The ChartStructureUpdating event's data class is ChartStructureChangingEventArgs. The following properties provide information specific to this event:

PropertyDescription
ChartModelReturns the model of a chart whose structure starts changing.

Remarks

You can use the ChartStructureUpdating event to complete 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.

See Also

ChartDesigner Class

ChartDesigner Members

DevExpress.XtraCharts.Designer Namespace