[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
    [Expand]Creating Charts
    [Collapse]Chart Elements
     [Expand]Chart Titles
       Annotations Overview
       Annotations Position and Layout
       Annotations Appearance
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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)

Annotations Position and Layout

This document describes how you can position annotations.

Expanded Relative and Absolute Position

The position of an annotation is specified via its Annotation.ShapePosition property, and it can be of two types.

Position Type Description

Free Position

If the Annotation.ShapePosition property is set to the FreePosition type, you can specify whether the anchor point is targeted to the chart or a pane (FreePosition.DockTarget), and choose the corner where the annotation is docked (FreePosition.DockCorner).

In addition, you can specify the indents from the annotation and its dock target element (chart or pane), via the FreePosition.InnerIndents and FreePosition.OuterIndents properties, whose values are summarized.

Relative Position

If the Annotation.ShapePosition property is set to the RelativePosition type, you can specify the annotation's angle at its anchor point (RelativePosition.Angle), and the length of its connecting line (RelativePosition.ConnectorLength).

Expanded Annotation Layout

By default, annotations that reside within the diagram and do not fit in its dimensions are cut off. You can make an annotation behave similarly to series labels, so that it shrinks the diagram, to completely fit, via the Annotation.LabelMode property.

LabelMode = false

LabelMode = true

To learn about the limitations imposed by using the label mode, refer to the Annotation.LabelMode property's description.

In addition, you can customize the size of the annotation (ImageAnnotation.SizeMode and TextAnnotation.AutoSize), and the angle by which the annotation's shape (where the annotation's image or text is displayed) is rotated (Annotation.Angle).

When multiple annotations are displayed, you can control their Z-order, via the Annotation.ZOrder property.

Expanded See Also

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