L'annotazione del markup del testo PDF consente di contrassegnare il testo (evidenziato, barrato, sottolineato, sottolineato ondulato) sulla pagina PDF.
Il
VintaSoft PDF .NET Plug-in fornisce un'API che consente di aggiungere a livello di programmazione un'
annotazione di markup di testo PDF alla pagina PDF.
L'SDK fornisce anche lo strumento visivo
PdfTextMarkupTool, che consente di marcare visivamente il testo utilizzando
Annotazione di testo PDF nelle pagine PDF visualizzate in WinForms o nel visualizzatore di immagini WPF. Le annotazioni aggiunte sono pienamente compatibili con qualsiasi visualizzatore PDF conforme alle specifiche PDF.
Ecco il codice C# che dimostra come contrassegnare il testo a livello di programmazione (evidenziare, barrare, sottolineare, sottolineare in modo ondulato) su una pagina PDF utilizzando l'annotazione PDF Text Markup:
/// <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);
}
Ecco il codice C# che dimostra come contrassegnare visivamente il testo su una pagina PDF visualizzata nel visualizzatore di immagini WinForms:
/// <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;
}
Inoltre, il pacchetto di installazione di
VintaSoft Imaging .NET SDK include le applicazioni "PDF Editor Demo" e "WPF PDF Editor Demo", che consentono di testare la funzionalità di markup del testo (evidenziazione, barrato, sottolineato, sottolineato ondulato) sulla pagina PDF senza alcuna codifica.
Per evidenziare e contrassegnare il testo utilizzando la barra degli strumenti in "Vintasoft PDF Editor Demo" è necessario:
- Fare clic su uno dei pulsanti di marcatura del testo situati nella casella degli strumenti ("Marcatura del testo utilizzando l'annotazione di marcatura del testo evidenziato", "Marcatura del testo utilizzando l'annotazione di marcatura del testo barrato", "Marcatura del testo utilizzando l'annotazione di marcatura del testo sottolineato" o "Marcatura del testo utilizzando l'annotazione di marcatura del testo ondulato")
- Selezionare il testo nel visualizzatore di immagini utilizzando il mouse
- Il testo verrà marcato utilizzando l'annotazione di marcatura del testo subito dopo la selezione.
Ecco uno screenshot che mostra come selezionare e contrassegnare il testo su una pagina PDF utilizzando la casella degli strumenti di "Vintasoft PDF Editor Demo":
Per annotare il testo selezionato utilizzando il menu contestuale in "Vintasoft PDF Editor Demo" è necessario:
- Fare clic su uno dei pulsanti di marcatura del testo situati nella casella degli strumenti ("Marcatura del testo utilizzando l'annotazione di marcatura del testo evidenziato", "Marcatura del testo utilizzando l'annotazione di marcatura del testo barrato", "Marcatura del testo utilizzando l'annotazione di marcatura del testo sottolineato" o "Marcatura del testo utilizzando l'annotazione di marcatura del testo ondulato")
- Scegli "Annotazione testo => Evidenzia" dal menu contestuale, il testo selezionato verrà annotato utilizzando l'annotazione di annotazione testo.
Ecco uno screenshot che mostra come annotare il testo selezionato sulla pagina PDF utilizzando il menu contestuale di "Vintasoft PDF Editor Demo":
