[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Charting Basics
   [Expand]Series Views
   [Expand]Chart Elements
   [Expand]Providing Data
   [Expand]Data Representation
   [Expand]Appearance Customization
   [Collapse]End-User Features
    [Expand]Basic End-User Interaction
    [Expand]Tooltip and Crosshair Cursor
     Print and Export
     Hit Information
     Chart Designer for End-Users
     Chart Ribbon and Toolbars
     Integration with a Range Control
     Chart Wizard for End-Users
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Additional Resources
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Chart Designer for End-Users

The Chart Designer allows end-users to customize chart appearance.

This document explains how to:

Expanded Invoke the Chart Designer

To invoke the Chart Designer, use the following code.

The code above uses the following classes and members.

Type or Member Description
ChartDesigner The Chart Designer.
ChartDesigner.ShowDialog Shows the Chart Designer.

Expanded Customize the Chart Designer

The Chart Designer supports appearance configuration, e.g., the dialog caption or icon change. In addition, its behavior can be changed using events.

The following code demonstrates all possibilities of designer customization.

The properties and events represented in the table below allow for the configuration of the Designer.

Property or Event Description
ChartDesigner.Caption Specifies the caption of the Designer dialog window.
ChartDesigner.Icon Specifies the icon of the Designer dialog window.
ChartDesigner.AvailableViewTypes Specifies the types of series view available to show on the chart.
ChartDesigner.AddElementMenuOptions Specifies parameters of the Add Element menu.
ChartDesigner.ChartElementHighlighting Occurs when chart element highlighting begins. Allows preventing element highlighting.
ChartDesigner.ChartElementSelecting Occurs when chart element selection begins. Allows you to prevent element selection or configure selected element visible editors.
ChartDesigner.ChartStructureUpdating Occurs when chart structure changes begin. Allows you to specify elements that are editable using the Chart Structure Tree.

The following code of event handlers demonstrates how the above-mentioned events can be processed.

Note that the ChartDesigner.ChartElementSelecting event allows you to specify the custom control used in the Options tab. The custom control must inherit the DevExpress.XtraCharts.Designer.CustomOptionsControl class. The image below shows the custom Legend Options tab.

The following code demonstrates how to design the Legend Options tab, which resembles the one in the image above.

Is this topic helpful?​​​​​​​