GetOrderedAnnotations Method (AnnotationManager)

In This Topic

Returns an array of GdPicture/XMP annotations, sorted by their Z-order, which are contained on the selected page of the document currently handled by this AnnotationManager object.

Be aware that this method only handles GdPicture/XMP annotations. Likewise, annotations are always treated relative to the selected page.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function GetOrderedAnnotations() As Annotation()

public Annotation[] GetOrderedAnnotations()

public function GetOrderedAnnotations(): array of Annotation;

public function GetOrderedAnnotations() : Annotation[];

public: Annotation*[]* GetOrderedAnnotations();

public:
array<Annotation^>^ GetOrderedAnnotations();

Return Value

An array of sorted Annotation objects by their Z-order contained on the currently selected page.

Remarks

Please ensure that you have selected the proper page before starting any annotation related action with the handled document. Annotations are always treated relative to the currently selected page.

Example

How to get the annotations contained on the current page sorted by their Z-order.

VB.NET
C#

Using annotationManager As AnnotationManager = New AnnotationManager()
    If (annotationManager.InitFromFile("annots.jpeg") = GdPictureStatus.OK) AndAlso
       (annotationManager.PageCount > 0) AndAlso (annotationManager.SelectPage(1) = GdPictureStatus.OK) Then
        Dim message As String = "Done!" + vbCrLf
        Dim annots As GdPicture14.Annotations.Annotation() = annotationManager.GetOrderedAnnotations()
        If annotationManager.GetStat() = GdPictureStatus.OK Then
            For i As Integer = 0 To annots.Count() - 1
                message += annots(i).GetType().ToString() + "  Z: " + annots(i).Zorder + vbCrLf
                'Or you can change the annotations Z-order here as you need.
            Next
            MessageBox.Show(message, "AnnotationManager.GetOrderedAnnotations")
        Else
            MessageBox.Show("Error!   Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.GetOrderedAnnotations")
        End If
    Else
        MessageBox.Show("The AnnotationManager can't be properly initialized. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.GetOrderedAnnotations")
    End If
End Using

using (AnnotationManager annotationManager = new AnnotationManager())
{
    if ((annotationManager.InitFromFile("annots.jpeg") == GdPictureStatus.OK) &&
        (annotationManager.PageCount > 0) && (annotationManager.SelectPage(1) == GdPictureStatus.OK))
    {
        string message = "Done!\n";
        GdPicture14.Annotations.Annotation[] annots = annotationManager.GetOrderedAnnotations();
        if (annotationManager.GetStat() == GdPictureStatus.OK)
        {
            for (int i = 0; i < annots.Count(); i++)
            {
                message += annots[i].GetType() + "  Z: " + annots[i].Zorder + "\n";
                //Or you can change the annotations Z - order here as you need.
            }
            MessageBox.Show(message, "AnnotationManager.GetOrderedAnnotations");
        }
        else
            MessageBox.Show("Error!   Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.GetOrderedAnnotations");
    }
    else
        MessageBox.Show("The AnnotationManager can't be properly initialized. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.GetOrderedAnnotations");
}

Reference

AnnotationManager Class
AnnotationManager Members
GetAnnotationCount Method
GetAnnotationIdx Method
GetAnnotationFromIdx Method
GetAnnotationType Method
DeleteAnnotation Method