Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ChartDesigner.ChartStructureUpdating Event

Used to customize the Chart Designer Elements’ Tree.

Namespace: DevExpress.XtraCharts.Designer

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

NuGet Package: DevExpress.Win.Charts

#Declaration

public event ChartStructureUpdatingEventHandler ChartStructureUpdating

#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 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