Annotation.RuntimeEditing Property

Specifies whether a user can edit the annotation.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v23.2.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public bool RuntimeEditing { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property RuntimeEditing As Boolean

Property Value

Type	Description
Boolean	true, if a user is allowed to modify the annotation; otherwise, false (default).

Remarks

When the RuntimeEditing property is enabled, a user can perform the following operations:

• Click the Delete key to remove a selected annotation.
• Double-click a text annotation to edit its content. Click Enter, Esc or a point outside the edit field to complete editing.
• To add a new line to a text annotation, click Shift + Enter.
• Double-click an image annotation and then select a new image in the invoked dialog.

The following code adds an annotation that a user can edit:

C#

TextAnnotation annotation = new TextAnnotation();
annotation.AnchorPoint = new ChartAnchorPoint(200, 200);
annotation.RuntimeEditing = true;
chartControl1.AnnotationRepository.Add(annotation);

VB.NET

Dim annotation As TextAnnotation = New TextAnnotation()
annotation.AnchorPoint = New ChartAnchorPoint(200, 200)
annotation.RuntimeEditing = True
chartControl1.AnnotationRepository.Add(annotation)

Note: Users can use the Add Text Annotation or Add Image Annotation buttons (reside in the Chart’s Ribbon or Toolbars) to create new annotations with RuntimeEditing enabled.