PdfFreeTextAnnotationFacade.SetCallout(PdfAnnotationLineEndingStyle, PdfPoint) Method

Adds a callout line to the free text annotation.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v24.1.Core.dll

NuGet Package: DevExpress.Pdf.Core

Declaration

C#

public void SetCallout(
    PdfAnnotationLineEndingStyle calloutLineEndingStyle,
    PdfPoint startPoint
)

VB.NET

Public Sub SetCallout(
    calloutLineEndingStyle As PdfAnnotationLineEndingStyle,
    startPoint As PdfPoint
)

Parameters

Name	Type	Description
calloutLineEndingStyle	PdfAnnotationLineEndingStyle	Indicates the ending style of the callout line.
startPoint	PdfPoint	The start point of the callout line.

Example

The code sample below creates a callout annotation pointed at a specific phrase:

C#

using (PdfDocumentProcessor processor = new PdfDocumentProcessor())
{
    // Load a document
    processor.LoadDocument("..\\..\\Document.pdf");

    // Access the first page properties
    PdfPageFacade pageFacade = processor.DocumentFacade.Pages[0];
    PdfRectangle calloutRectangle;

    // Find the target phrase in the document
    string calloutText = "Evaluation";
    PdfTextSearchResults searchResults = processor.FindText(calloutText);

    if (searchResults.Status == PdfTextSearchStatus.Found)
    {
        // Obtain the target phrase rectangle
        calloutRectangle = searchResults.Rectangles[0].BoundingRectangle;

        // Define an annotation area
        PdfRectangle rectangle = new PdfRectangle(663, 526, 763, 576);

        // Create a free text annotation in this area
        PdfFreeTextAnnotationFacade freeText =
            pageFacade.AddFreeTextAnnotation(rectangle, "Free Text Annotation");

        // Specify annotation parameters
        freeText.Author = "Nancy Davolio";

        // Add a callout line pointed at the center of the target phrase
        freeText.SetCallout(PdfAnnotationLineEndingStyle.OpenArrow, calloutRectangle.Center);
    }

    // Save the result
    processor.SaveDocument("..\\..\\Result.pdf");
}

VB.NET

Using processor As New PdfDocumentProcessor()
  ' Load a document
  processor.LoadDocument("..\..\Document.pdf")

  ' Access the first page properties
  Dim pageFacade As PdfPageFacade = processor.DocumentFacade.Pages(0)
  Dim calloutRectangle As PdfRectangle

  ' Find the target phrase in the document
  Dim calloutText As String = "Evaluation"
  Dim searchResults As PdfTextSearchResults = processor.FindText(calloutText)

  If searchResults.Status = PdfTextSearchStatus.Found Then

    ' Obtain the target phrase rectangle
    calloutRectangle = searchResults.Rectangles(0).BoundingRectangle

    ' Define an annotation area
    Dim rectangle As New PdfRectangle(663, 526, 763, 576)

    ' Create a free text annotation in this area
    Dim freeText As PdfFreeTextAnnotationFacade =
       pageFacade.AddFreeTextAnnotation(rectangle, "Free Text Annotation")

    ' Specify annotation parameters
    freeText.Author = "Nancy Davolio"

    ' Add a callout line pointed at the center of the target phrase
    freeText.SetCallout(PdfAnnotationLineEndingStyle.OpenArrow, calloutRectangle.Center)
  End If

  ' Save the result
  processor.SaveDocument("..\..\Result.pdf")s
End Using