AddLineAnnot Method (AnnotationManager)

In This Topic

Adds a new GdPicture/XMP line annotation on the selected page of the document currently handled by this AnnotationManager object according to the parameters you have specified. A line annotation presents a single straight line drawn with the defined color, which uses the flat cap style on both its ending points.

The type of the newly added annotation object is GdPictureAnnotationType.AnnotationTypeLine. You can change the annotation properties directly using the GdPicture14.Annotations.AnnotationLine class right after the successful creation of the annotation object.

Be aware that annotations are always treated relative to the currently selected page.

Adds a new GdPicture/XMP line annotation on the selected page of the document currently handled by this AnnotationManager object.

Syntax

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

'Declaration

 

Public Function AddLineAnnot( _

   ByVal BorderColor As Color, _

   ByVal SrcLeft As Single, _

   ByVal SrcTop As Single, _

   ByVal DstLeft As Single, _

   ByVal DstTop As Single _

) As AnnotationLine

public AnnotationLine AddLineAnnot( 

   Color BorderColor,

   float SrcLeft,

   float SrcTop,

   float DstLeft,

   float DstTop

)

public function AddLineAnnot( 

    BorderColor: Color;

    SrcLeft: Single;

    SrcTop: Single;

    DstLeft: Single;

    DstTop: Single

): AnnotationLine;

public function AddLineAnnot( 

   BorderColor : Color,

   SrcLeft : float,

   SrcTop : float,

   DstLeft : float,

   DstTop : float

) : AnnotationLine;

public: AnnotationLine* AddLineAnnot( 

   Color BorderColor,

   float SrcLeft,

   float SrcTop,

   float DstLeft,

   float DstTop

)

public:

AnnotationLine^ AddLineAnnot( 

   Color BorderColor,

   float SrcLeft,

   float SrcTop,

   float DstLeft,

   float DstTop

)

Parameters

BorderColor: A color object that defines the required color of the newly added line annotation. It corresponds to the AnnotationLine.StrokeColor property.
SrcLeft: The horizontal (X) coordinate of the starting point of the drawn line, in inches.
SrcTop: The vertical (Y) coordinate of the starting point of the drawn line, in inches.
DstLeft: The horizontal (X) coordinate of the ending point of the drawn line, in inches.
DstTop: The vertical (Y) coordinate of the ending point of the drawn line, in inches.

Return Value

A GdPicture/XMP AnnotationLine object. The newly added GdPicture/XMP line annotation.

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.

You can regularly apply the GetStat method to determine if this method has been successful.

Example

How to use a line annotation to permanently underline found text.

VB.NET
C#

'We assume that the GdViewer1 control has been integrated into your application.

If GdViewer1.DisplayFromFile("text_to_search.txt") = GdPictureStatus.OK Then

    Dim annotMgr As AnnotationManager = GdViewer1.GetAnnotationManager()

    If (annotMgr IsNot Nothing) AndAlso (annotMgr.SelectPage(1) = GdPictureStatus.OK) Then

        Dim text_to_find As String = "GdPicture"

        Dim occurrence As Integer = 1

        Dim left As Single = 0, top As Single = 0, width As Single = 0, height As Single = 0

        Dim text_found As Boolean = False

        GdViewer1.RemoveAllRegions()

        While GdViewer1.SearchText(GdViewer1.CurrentPage, text_to_find, occurrence, True, left, top, width, height)

            text_found = True

            Dim annotLine As GdPicture14.Annotations.AnnotationLine = annotMgr.AddLineAnnot(Color.Blue, left, top + height, left + width, top + height)

            If (annotMgr.GetStat() = GdPictureStatus.OK) AndAlso (annotLine IsNot Nothing) Then

                annotLine.Author = "GdPicture"

                annotLine.BorderWidth = 0.05F

                annotLine.Tag = "Line"

            End If

            annotLine.Dispose()

            occurrence = occurrence + 1

        End While

        If text_found Then

            If (annotMgr.SaveAnnotationsToPage() <> GdPictureStatus.OK) OrElse

               (annotMgr.BurnAnnotationsToPage(True) <> GdPictureStatus.OK) OrElse

               (annotMgr.SaveDocumentToJPEG("text_lines.jpg", 75) <> GdPictureStatus.OK) Then

                MessageBox.Show("An error occurred when saving the file. Status: " + annotMgr.GetStat().ToString(), "AnnotationManager.AddLineAnnot")

            End If

            GdViewer1.Redraw()

        Else

            MessageBox.Show("The given text has not been found.", "AnnotationManager.AddLineAnnot")

        End If

    Else

        MessageBox.Show("The AnnotationManager can't be initialized.", "AnnotationManager.AddLineAnnot")

    End If

Else

    MessageBox.Show("The file can't be displayed. Status: " + GdViewer1.GetStat().ToString(), "AnnotationManager.AddLineAnnot")

End If

//We assume that the GdViewer1 control has been integrated into your application.

if (GdViewer1.DisplayFromFile("text_to_search.txt") == GdPictureStatus.OK)

{

    AnnotationManager annotMgr = GdViewer1.GetAnnotationManager();

    if ((annotMgr != null) && (annotMgr.SelectPage(1) == GdPictureStatus.OK))

    {

        string text_to_find = "GdPicture";

        int occurrence = 1;

        float left = 0, top = 0, width = 0, height = 0;

        bool text_found = false;

        GdViewer1.RemoveAllRegions();

        while (GdViewer1.SearchText(GdViewer1.CurrentPage, text_to_find, occurrence, true, ref left, ref top, ref width, ref height))

        {

            text_found = true;

            GdPicture14.Annotations.AnnotationLine annotLine = annotMgr.AddLineAnnot(Color.Blue, left, top+height, left+width, top+height);

            if ((annotMgr.GetStat() == GdPictureStatus.OK) && (annotLine != null))

            {

                annotLine.Author = "GdPicture";

                annotLine.BorderWidth = 0.05f;

                annotLine.Tag = "Line";

            }

            annotLine.Dispose();

            occurrence = occurrence + 1;

        }

        if (text_found)

        {

            if ((annotMgr.SaveAnnotationsToPage() != GdPictureStatus.OK) ||

                (annotMgr.BurnAnnotationsToPage(true) != GdPictureStatus.OK) ||

                (annotMgr.SaveDocumentToJPEG("text_lines.jpg", 75) != GdPictureStatus.OK))

                MessageBox.Show("An error occurred when saving the file. Status: " + annotMgr.GetStat().ToString(), "AnnotationManager.AddLineAnnot");

            GdViewer1.Redraw();

        }

        else

            MessageBox.Show("The given text has not been found.", "AnnotationManager.AddLineAnnot");

    }

    else

        MessageBox.Show("The AnnotationManager can't be initialized.", "AnnotationManager.AddLineAnnot");

}

else

    MessageBox.Show("The file can't be displayed. Status: " + GdViewer1.GetStat().ToString(), "AnnotationManager.AddLineAnnot");

Example

How to use a line annotation to permanently underline found text. 'We assume that the GdViewer1 control has been integrated into your application. If GdViewer1.DisplayFromFile("text_to_search.txt") = GdPictureStatus.OK Then Dim annotMgr As AnnotationManager = GdViewer1.GetAnnotationManager() If (annotMgr IsNot Nothing) AndAlso (annotMgr.SelectPage(1) = GdPictureStatus.OK) Then Dim text_to_find As String = "GdPicture" Dim occurrence As Integer = 1 Dim left As Single = 0, top As Single = 0, width As Single = 0, height As Single = 0 Dim text_found As Boolean = False GdViewer1.RemoveAllRegions() While GdViewer1.SearchText(GdViewer1.CurrentPage, text_to_find, occurrence, True, left, top, width, height) text_found = True Dim annotLine As GdPicture14.Annotations.AnnotationLine = annotMgr.AddLineAnnot(Color.Blue, left, top + height, left + width, top + height) If (annotMgr.GetStat() = GdPictureStatus.OK) AndAlso (annotLine IsNot Nothing) Then annotLine.Author = "GdPicture" annotLine.BorderWidth = 0.05F annotLine.Tag = "Line" End If annotLine.Dispose() occurrence = occurrence + 1 End While If text_found Then If (annotMgr.SaveAnnotationsToPage() <> GdPictureStatus.OK) OrElse (annotMgr.BurnAnnotationsToPage(True) <> GdPictureStatus.OK) OrElse (annotMgr.SaveDocumentToJPEG("text_lines.jpg", 75) <> GdPictureStatus.OK) Then MessageBox.Show("An error occurred when saving the file. Status: " + annotMgr.GetStat().ToString(), "AnnotationManager.AddLineAnnot") End If GdViewer1.Redraw() Else MessageBox.Show("The given text has not been found.", "AnnotationManager.AddLineAnnot") End If Else MessageBox.Show("The AnnotationManager can't be initialized.", "AnnotationManager.AddLineAnnot") End If Else MessageBox.Show("The file can't be displayed. Status: " + GdViewer1.GetStat().ToString(), "AnnotationManager.AddLineAnnot") End If //We assume that the GdViewer1 control has been integrated into your application. if (GdViewer1.DisplayFromFile("text_to_search.txt") == GdPictureStatus.OK) { AnnotationManager annotMgr = GdViewer1.GetAnnotationManager(); if ((annotMgr != null) && (annotMgr.SelectPage(1) == GdPictureStatus.OK)) { string text_to_find = "GdPicture"; int occurrence = 1; float left = 0, top = 0, width = 0, height = 0; bool text_found = false; GdViewer1.RemoveAllRegions(); while (GdViewer1.SearchText(GdViewer1.CurrentPage, text_to_find, occurrence, true, ref left, ref top, ref width, ref height)) { text_found = true; GdPicture14.Annotations.AnnotationLine annotLine = annotMgr.AddLineAnnot(Color.Blue, left, top+height, left+width, top+height); if ((annotMgr.GetStat() == GdPictureStatus.OK) && (annotLine != null)) { annotLine.Author = "GdPicture"; annotLine.BorderWidth = 0.05f; annotLine.Tag = "Line"; } annotLine.Dispose(); occurrence = occurrence + 1; } if (text_found) { if ((annotMgr.SaveAnnotationsToPage() != GdPictureStatus.OK) || (annotMgr.BurnAnnotationsToPage(true) != GdPictureStatus.OK) || (annotMgr.SaveDocumentToJPEG("text_lines.jpg", 75) != GdPictureStatus.OK)) MessageBox.Show("An error occurred when saving the file. Status: " + annotMgr.GetStat().ToString(), "AnnotationManager.AddLineAnnot"); GdViewer1.Redraw(); } else MessageBox.Show("The given text has not been found.", "AnnotationManager.AddLineAnnot"); } else MessageBox.Show("The AnnotationManager can't be initialized.", "AnnotationManager.AddLineAnnot"); } else MessageBox.Show("The file can't be displayed. Status: " + GdViewer1.GetStat().ToString(), "AnnotationManager.AddLineAnnot");

Reference

AnnotationManager Class
AnnotationManager Members
AnnotationLine Class
GetStat Method
SelectPage Method
SaveAnnotationsToPage Method
GetAnnotationCount Method
GetAnnotationIdx Method
GetAnnotationType Method
DeleteAnnotation Method