[Expand]General Information
[Collapse]WinForms Controls
 [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
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Providing Data
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Collapse]Design-Time Features
     Chart Designer
    [Expand]Chart Wizard
     Pattern Editor
   [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]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]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Pattern Editor

This topic describes the purpose of a Pattern Editor, provides a brief overview of its sections and explains how to use this editor to create a pattern at design time.

The Pattern Editor is used to simplify text customization of series labels, axis labels and legend items. The editor contains a lot of built-in predefined placeholders that can be used together with the different format specifiers to create a pattern for date-time, numeric, currency and other data types.

The Pattern Editor can be invoked for the AxisLabel.TextPattern, SeriesLabelBase.TextPattern and SeriesBase.LegendTextPattern properties in the Properties window using the ellipsis button.


The Pattern Editor also can be used to format a text displayed in crosshair labels (the CrosshairAxisLabelOptions.Pattern, SeriesBase.CrosshairLabelPattern, CrosshairOptions.GroupHeaderPattern properties) and within a tooltip (the SeriesBase.ToolTipPointPattern and SeriesBase.ToolTipSeriesPattern properties).

The customization of legend items works when the SeriesViewColorEachSupportBase.ColorEach mode is enabled (the ColorEach is always enabled, by default, for Pie, Doughnut and Nested Doughnut charts).

To invoke the Pattern Editor, for example, for the Side-by-Side Bar series labels:


To show series labels in the chart, make sure the SeriesBase.LabelsVisibility property is set to true.

In the invoked Pattern Editor, you can see 'Placeholders:', 'Pattern:' and 'Format:' columns.

The table below lists Pattern Editor elements and explains their function.

Editor Element Function
The 'Placeholders:' column Contains a predefined set of placeholders, the number of which varies depending on the series type.

You can see the full list of available placeholders in the corresponding section of the TextPattern properties.

The 'Format': column Contains predefined DateTime, Number, Percent, Currency and Special formats.
The 'Pattern:' column Displays a pattern created by the addition of items from the 'Placeholders:' and 'Format:' columns.
The '>' button Adds a selected placeholder from the 'Placeholder' column to the 'Pattern:' column.
The '>>' button Adds all available placeholders from the 'Placeholder' column to the 'Pattern:' column.
The Pattern preview Displays the preview result of applying a pattern (the pattern is located in the 'Pattern:' column) to the chart element (series labels, axis labels or legend items).
The 'OK' button Applies a pattern (if the pattern exists in the 'Pattern' column) to the corresponding text pattern property and closes the editor.
The 'Cancel' button Cancels the operation of applying a pattern (if the pattern has not saved before using the 'OK' button) to the corresponding text pattern property and closes the editor.

Expanded Examples

The following examples illustrate how to create a pattern and apply it to chart elements (series labels, axis labels and legend items) using the Pattern Editor.

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