ChartControl.AnnotationRepositoryChanging Event

Occurs when a user adds, edits or deletes an annotation before the user’s operation is applied to the annotation repository.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.UI.dll

NuGet Package: DevExpress.Win.Charts

Declaration

C#

public event AnnotationRepositoryChangingEventHandler AnnotationRepositoryChanging

VB.NET

Public Event AnnotationRepositoryChanging As AnnotationRepositoryChangingEventHandler

Event Data

The AnnotationRepositoryChanging event's data class is AnnotationRepositoryChangingEventArgs. The following properties provide information specific to this event:

Property	Description
Annotation	Returns the annotation that is being changed.
Cancel	Indicates whether to cancel the annotation change.
Change	Returns the AnnotationRepositoryChange value that indicates the type of change a user makes.

Remarks

Users can utilize the Add Text Annotation and Add Image Annotation buttons in the Chart’s Ribbon or Toolbars to add interactive annotations. They can also edit or delete an annotation if the Annotation.RuntimeEditing property is set to true.

The e.Change property returns an operation that a user performs. The Change property can be set to the following values:

• Addition
• Deletion
• Image
• Text

The e.Annotation property returns the changed annotation. The e.Cancel property indicates whether to cancel the last change.

The following example prevents Annotation1 from being deleted.

C#

void chartControl1_AnnotationRepositoryChanging(object sender, AnnotationRepositoryChangingEventArgs e) {
    if (e.Annotation.Name == "Annotation1" && e.Change == AnnotationRepositoryChange.Deletion) {
        e.Cancel = true;
    }
}

VB.NET

Private Sub chartControl1_AnnotationRepositoryChanging(ByVal sender As Object, ByVal e As AnnotationRepositoryChangingEventArgs)
    If e.Annotation.Name = "Annotation 1" AndAlso e.Change = AnnotationRepositoryChange.Deletion Then
        e.Cancel = True
    End If
End Sub

When a user edits an image annotation, use AnnotationImageEditingEventArgs to get a file path to the new annotation image. Cast AnnotationRepositoryChangingEventArgs to the AnnotationImageEditingEventArgs type and use the AnnotationImageEditingEventArgs.NewImageFileName property for this purpose:

C#

 void chartControl1_AnnotationRepositoryChanging(object sender, AnnotationRepositoryChangingEventArgs e) {
    if (e.Change == AnnotationRepositoryChange.Image) {
    AnnotationImageEditingEventArgs imageEditingArgs = (AnnotationImageEditingEventArgs)e;
    string imageFile = imageEditingArgs.NewImageFileName;
    //Add your logic here. 
    }
 }    

VB.NET

Private Sub chartControl1_AnnotationRepositoryChanging(ByVal sender As Object, ByVal e As AnnotationRepositoryChangingEventArgs)
    If e.Change = AnnotationRepositoryChange.Image Then
        Dim imageEditingArgs As AnnotationImageEditingEventArgs = CType(e, AnnotationImageEditingEventArgs)
        Dim imageFile As String = imageEditingArgs.NewImageFileName
    End If
'Add your logic here.     
End Sub

When a user edits a text annotation, use the AnnotationTextEditingEventArgs to get new annotation text. Cast the AnnotationRepositoryChangingEventArgs to the AnnotationTextEditingEventArgs type. The AnnotationTextEditingEventArgs.NewText property returns new text as shown in the following example:

C#

void chartControl1_AnnotationRepositoryChanging(object sender, AnnotationRepositoryChangingEventArgs e) {
    if (e.Change == AnnotationRepositoryChange.Text) {
    AnnotationTextEditingEventArgs textEditingArgs = (AnnotationTextEditingEventArgs)e;
    string newAnnotationText = textEditingArgs.NewText;
    //Add your logic here. 
    }    
}

VB.NET

Private Sub chartControl1_AnnotationRepositoryChanging(ByVal sender As Object, ByVal e As AnnotationRepositoryChangingEventArgs)
    If e.Change = AnnotationRepositoryChange.Text Then
        Dim textEditingArgs As AnnotationTextEditingEventArgs = CType(e, AnnotationTextEditingEventArgs)
        Dim newAnnotationText As String = textEditingArgs.NewText
        'Add your logic here.
    End If
End Sub