.NET의 텍스트 마크업 주석을 사용하여 PDF 페이지의 텍스트에 마크업하기

PDF 텍스트 마크업 주석을 사용하면 PDF 페이지의 텍스트에 마크업(강조, 취소선, 밑줄, 물결선)을 적용할 수 있습니다.
VintaSoft PDF .NET Plug-in은 PDF 페이지에 PDF 텍스트 마크업 주석을 프로그래밍 방식으로 추가할 수 있는 API를 제공합니다.
또한 SDK는 PdfTextMarkupTool이라는 시각적 도구를 제공합니다. 이 도구를 사용하면 WinForms 또는 WPF 이미지 뷰어에 표시되는 PDF 페이지에서 PDF 텍스트 마크업 주석을 사용하여 텍스트를 시각적으로 마크업할 수 있습니다. 추가된 주석은 PDF 사양을 준수하는 모든 PDF 뷰어와 완벽하게 호환됩니다.


다음은 PDF 텍스트 마크업 주석을 사용하여 PDF 페이지의 텍스트에 프로그래밍 방식으로 마크업(강조, 취소선, 밑줄, 물결선)하는 방법을 보여주는 C# 코드입니다.

/// <summary>
/// Highlights specified text in PDF document.
/// </summary>
/// <param name="inputPdfFilename">The input PDF filename.</param>
/// <param name="outputPdfFilename">The output PDF filename.</param>
/// <param name="text">A text that must be highlighted.</param>
public static void HiglightTextInPdfDocument(string inputPdfFilename, string outputPdfFilename, string text)
{
    MarkupTextInPdfDocument(inputPdfFilename, outputPdfFilename, 
        Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType.Highlight, System.Drawing.Color.Orange, text);
}

/// <summary>
/// Strikeouts specified text in PDF document.
/// </summary>
/// <param name="inputPdfFilename">The input PDF filename.</param>
/// <param name="outputPdfFilename">The output PDF filename.</param>
/// <param name="text">A text that must be striked out.</param>
public static void StrikeoutTextInPdfDocument(string inputPdfFilename, string outputPdfFilename, string text)
{
    MarkupTextInPdfDocument(inputPdfFilename, outputPdfFilename, 
        Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType.StrikeOut, System.Drawing.Color.Red, text);
}

/// <summary>
/// Underlines specified text in PDF document.
/// </summary>
/// <param name="inputPdfFilename">The input PDF filename.</param>
/// <param name="outputPdfFilename">The output PDF filename.</param>
/// <param name="text">A text that must be underlined.</param>
public static void UnderlineTextInPdfDocument(string inputPdfFilename, string outputPdfFilename, string text)
{
    MarkupTextInPdfDocument(inputPdfFilename, outputPdfFilename, 
        Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType.Underline, System.Drawing.Color.Green, text);
}

/// <summary>
/// Squiggly undelines specified text in PDF document.
/// </summary>
/// <param name="inputPdfFilename">The input PDF filename.</param>
/// <param name="outputPdfFilename">The output PDF filename.</param>
/// <param name="text">A text that must be squiggly underlined.</param>
public static void SquigglyUnderlineTextInPdfDocument(string inputPdfFilename, string outputPdfFilename, string text)
{
    MarkupTextInPdfDocument(inputPdfFilename, outputPdfFilename, 
        Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType.Squiggly, System.Drawing.Color.Blue, text);
}

/// <summary>
/// Markups specified text in PDF document.
/// </summary>
/// <param name="inputPdfFilename">The input PDF filename.</param>
/// <param name="outputPdfFilename">The output PDF filename.</param>
/// <param name="color">The markup annotation color.</param>
/// <param name="annotationType">The markup annotation type.</param>
/// <param name="text">A text to markup.</param>
private static void MarkupTextInPdfDocument(
    string inputPdfFilename,
    string outputPdfFilename,
    Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType annotationType,
    System.Drawing.Color color,
    string text)
{
    // open input PDF document
    using (Vintasoft.Imaging.Pdf.PdfDocument document = new Vintasoft.Imaging.Pdf.PdfDocument(inputPdfFilename))
    {
        // for each PDF page
        foreach (Vintasoft.Imaging.Pdf.Tree.PdfPage page in document.Pages)
        {
            // extract text region of PDF page
            Vintasoft.Imaging.Text.TextRegion pageTextRegion = page.ExtractTextRegion(false);

            // search and markup all specified text on PDF page
            int index = 0;
            Vintasoft.Imaging.Text.TextRegion foundText;
            while (true)
            {
                // find next text
                foundText = pageTextRegion.FindText(text, ref index, false);
                if (foundText == null)
                    break;
                index += foundText.Symbols.Length;

                // markup found text
                MarkupText(page, foundText, annotationType, color);
            }
        }

        // save PDF document to output file
        document.SaveChanges(outputPdfFilename);
    }
}

/// <summary>
/// Markups specified text region in PDF page.
/// </summary>
/// <param name="page">The page.</param>
/// <param name="textRegion">The text region to markup.</param>
/// <param name="color">The markup annotation color.</param>
/// <param name="annotationType">The markup annotation type.</param>
private static void MarkupText(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page,
    Vintasoft.Imaging.Text.TextRegion textRegion,
    Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationType annotationType,
    System.Drawing.Color color)
{
    // create markup annotation of specified type
    Vintasoft.Imaging.Pdf.Tree.Annotations.PdfTextMarkupAnnotation markupAnnotation =
        new Vintasoft.Imaging.Pdf.Tree.Annotations.PdfTextMarkupAnnotation(page, annotationType);

    // set annotation properties
    markupAnnotation.SetTextRegion(textRegion);
    markupAnnotation.Color = color;
    markupAnnotation.Title = System.Environment.UserName;
    markupAnnotation.CreationDate = System.DateTime.Now;

    // generate annotation appearance
    markupAnnotation.UpdateAppearance();

    // add annotation to annotations of PDF page
    if (page.Annotations == null)
        page.Annotations = new Vintasoft.Imaging.Pdf.Tree.Annotations.PdfAnnotationList(page.Document);
    page.Annotations.Add(markupAnnotation);
}

다음은 WinForms 이미지 뷰어에 표시된 PDF 페이지의 텍스트에 시각적으로 마크업하는 방법을 보여주는 C# 코드입니다.

/// <summary>
/// Sets the PdfTextMarkupTool as current visual tool in specified image viewer.
/// </summary>
/// <param name="imageViewer">The image viewer.</param>
public static void SetPdfTextMarkupTool(Vintasoft.Imaging.UI.ImageViewer imageViewer)
{
    // create an instance of the PdfTextMarkupTool class
    Vintasoft.Imaging.Pdf.UI.PdfTextMarkupTool textMarkupTool = new Vintasoft.Imaging.Pdf.UI.PdfTextMarkupTool();

    // set text markup mode to "Highlight"
    textMarkupTool.MarkupMode = Vintasoft.Imaging.Pdf.UI.PdfTextMarkupToolMode.Highlight;

    // set color of markup annotation to "Orange"
    textMarkupTool.HighlightColor = System.Drawing.Color.Orange;

    // subscribe to the MarkupAnnotationCreated event
    textMarkupTool.MarkupAnnotationCreated += TextMarkupTool_MarkupAnnotationCreated;

    // get TextSelectionTool from image viewer
    Vintasoft.Imaging.UI.VisualTools.TextSelectionTool textSelectionTool = GetTextSelectionTool(imageViewer);

    // set the PdfTextMarkupTool+TextSelectionTool as visual tool of the image viewer
    imageViewer.VisualTool = new Vintasoft.Imaging.UI.VisualTools.CompositeVisualTool(textMarkupTool, textSelectionTool);
}

/// <summary>
/// Returns the text selection tool for specified image viewer.
/// </summary>
/// <param name="imageViewer">The image viewer.</param>
/// <returns>The text selection tool.</returns>
private static Vintasoft.Imaging.UI.VisualTools.TextSelectionTool GetTextSelectionTool(Vintasoft.Imaging.UI.ImageViewer imageViewer)
{
    // search a TextSelectionTool in visual tools of the image viewer
    Vintasoft.Imaging.UI.VisualTools.TextSelectionTool textSelectionTool =
        Vintasoft.Imaging.UI.VisualTools.VisualTool.FindVisualTool<Vintasoft.Imaging.UI.VisualTools.TextSelectionTool>(imageViewer.VisualTool);
    if (textSelectionTool != null)
        return textSelectionTool;

    // create an instance of text selection tool
    return new Vintasoft.Imaging.UI.VisualTools.TextSelectionTool();
}

/// <summary>
/// Handles the MarkupAnnotationCreated event of the PdfTextMarkupTool visual tool.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="Vintasoft.Imaging.Pdf.UI.PdfTextMarkupAnnotationEventArgs" /> instance containing the event data.</param>
private static void TextMarkupTool_MarkupAnnotationCreated(object sender, Vintasoft.Imaging.Pdf.UI.PdfTextMarkupAnnotationEventArgs e)
{
    // set user name as title of text markup annotation
    e.MarkupAnnotation.Title = System.Environment.UserName;
}

또한 VintaSoft Imaging .NET SDK 설치 패키지에는 텍스트 마크업 기능(강조, 취소선, 밑줄, 물결선)을 테스트할 수 있는 PDF 편집기 데모 및 WPF PDF 편집기 데모 애플리케이션이 포함되어 있습니다. 코딩 없이 PDF 페이지에서 텍스트를 강조 표시하고 마크업하려면 다음 단계를 따르세요.

Vintasoft PDF Editor 데모에서 툴바를 사용하여 텍스트를 강조 표시하고 마크업하려면 다음 단계를 따르세요.

• 툴박스에 있는 텍스트 마크업 버튼 중 하나를 클릭합니다("강조 텍스트 마크업 주석으로 텍스트 마크업", "취소선 텍스트 마크업 주석으로 텍스트 마크업", "밑줄 텍스트 마크업 주석으로 텍스트 마크업" 또는 "물결선 밑줄 텍스트 마크업 주석으로 텍스트 마크업").
• 마우스를 사용하여 이미지 뷰어에서 텍스트를 선택합니다.
• 선택한 텍스트에 텍스트 마크업 주석이 즉시 적용됩니다.

다음은 Vintasoft PDF Editor Demo의 도구 상자를 사용하여 PDF 페이지에서 텍스트를 선택하고 마크업하는 방법을 보여주는 스크린샷입니다.



Vintasoft PDF Editor 데모에서 컨텍스트 메뉴를 사용하여 선택한 텍스트에 마크업하려면 다음 단계를 따르세요.

• 툴박스에 있는 텍스트 마크업 버튼 중 하나를 클릭합니다("강조 텍스트 마크업 주석으로 텍스트 마크업", "취소선 텍스트 마크업 주석으로 텍스트 마크업", "밑줄 텍스트 마크업 주석으로 텍스트 마크업" 또는 "물결선 밑줄 텍스트 마크업 주석으로 텍스트 마크업").
• 컨텍스트 메뉴에서 "텍스트 마크업 => 강조 표시"를 선택하면 선택한 텍스트에 텍스트 마크업 주석이 적용됩니다.

다음은 Vintasoft PDF Editor 데모의 컨텍스트 메뉴를 사용하여 PDF 페이지에서 선택한 텍스트에 마크업하는 방법을 보여주는 스크린샷입니다.