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
   [Collapse]Fundamentals
    [Expand]Charting Basics
    [Expand]Professional Charting
    [Expand]Series Views
    [Collapse]Chart Elements
     [Expand]Series
     [Expand]Diagram
      Chart Titles
     [Collapse]Legends
       Adding Legends
       Legends Alignment and Layout
       Legends Appearance
       Legend Title
       Legend Items
     [Expand]Annotations
   [Expand]Providing Data
   [Expand]Appearance Customization
   [Expand]End-User Features
   [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

Legends

The Legend is an explanatory component that accompanies a chart's diagram, identifying its most important visual elements: series, series points (in some cases), constant lines, strips, and indicators.

Note that it is possible to create multiple legends on each chart. Refer to the Adding Legends topic to learn how to add several legends to a chart.

In most cases, a legend displays series names, however, it can also show data points that belong to the same series. To apply this legend representation format to series of most view types, enable their SeriesViewColorEachSupportBase.ColorEach property. Note that this legend view is automatically applied to the Pie series.

A legend that lists and identifies data points belonging to a single series is demonstrated in the following image, using a pie chart as an example:

Each item shown in the legend can be represented by:

  • a textual description only;

  • a marker and textual description pair for the legend item (the default option);

  • a check box and textual description pair for the legend item.

  • a check box, marker and textual description triplet for the legend item.

  • a marker, check box and textual description triplet for the legend item.

The Legend.MarkerMode property controls a marker and check box visibility and order. Refer to the Legend Items document for more information about legend items.

Note

The chart's visual element can be displayed on a legend if its Visible and ShowInLegend properties are enabled (ConstantLine.Visible, Indicator.Visible, SeriesBase.Visible, Strip.Visible).

If you wish to see multiple series on a legend, they should have compatible view types. Refer to the Series Views Compatibility topic for details.

A legend title can accompany a legend, as the following image demonstrates:

Refer to the Legend Title document For more information about legend titles.

A legend is positioned relative to a chart or a pane. For example, in the following image all legends are inside panes with different alignments:

Refer to the Legends Alignment and Layout topic for more information about legend positioning.

You can modify the legend font, background, border and add a shadow if its appearance does not meet your requirements. Refer to the Legends Appearance topic for more information.

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