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
     [Expand]Legends
     [Collapse]Annotations
       Annotations Position and Layout
       Annotations Appearance
   [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

Annotations

This document describes how annotations can be created, anchored to various chart elements and customized, and illustrates their general functionality.

Two different annotation types are available: text and image annotations (represented by the TextAnnotation and ImageAnnotation class instances, respectively).

You can access, manage and customize all annotations that are present in a chart control, via its ChartControl.AnnotationRepository property. At design time, access it quickly via the chart control's smart tag.

Annotations can be created for a chart, pane, or series point.

The Annotation.AnchorPoint property value determines to which element's collection an annotation is added.

The anchor point type The example image Description

Chart Anchoring

If the Annotation.AnchorPoint property is set to a ChartAnchorPoint type, the annotation is added to the chart's collection, returned by its ChartControl.Annotations property.

Then, you can adjust the annotations position on the chart's surface, by specifying its distance from the chart's left and top edges, via the ChartAnchorPoint.X and ChartAnchorPoint.Y properties.

These coordinates position an annotation absolutely, meaning that the anchor point doesn't change when a chart is being resized.

For a step-by-step tutorial, refer to How to: Create an Image Annotation Anchored to a Chart or Pane.

Pane Anchoring

If the Annotation.AnchorPoint property is set to a PaneAnchorPoint type, the annotation is added to the pane's collection, returned by its XYDiagramPaneBase.Annotations property.

Then, you can specify to which particular pane the annotation is anchored (via the PaneAnchorPoint.Pane property), and define the axes and their values for the annotation's anchor point (via the PaneAnchorPoint.AxisXCoordinate and PaneAnchorPoint.AxisYCoordinate properties).

If the pane, to which an annotation is anchored, is removed, the annotation is removed, as well.

For a step-by-step tutorial, refer to How to: Create an Image Annotation Anchored to a Chart or Pane.

Series Point Anchoring

If the Annotation.AnchorPoint property is set to a SeriesPointAnchorPoint type, the annotation is added to the point's collection, returned by its SeriesPoint.Annotations property.

Then, you can specify to which particular series point the annotation is anchored (via the SeriesPointAnchorPoint.SeriesPoint property).

If the series point, to which an annotation is anchored, is removed, the annotation is removed, as well.

For a step-by-step tutorial, refer to How to: Create a Text Annotation Anchored to a Series Point.

After annotation anchoring, the position of the annotation can be specified. For more information about positioning and layout, refer to the Annotations Position and Layout document.

Besides, the annotations appearance is deeply customizable. Refer to the Annotations Appearance topic to learn more.

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