Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Fundamentals
   [Expand]Providing Data
   [Expand]Appearance Customization
   [Collapse]End-User Features
    [Expand]Basic End-User Interaction
    [Expand]Crosshair Cursor
     Tooltips
    [Expand]Animation
     Printing and Exporting
     Chart Designer for End-Users
     Integration with a Range Control
     Chart Wizard for End-Users
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Additional Resources
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap 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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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.

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T462899.

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.

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T462899.

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.

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T462899.

How would you rate this topic?​​​​​​​