Mettre en surbrillance un caractère dans un fichier PDF

Introduction

Lorsque vous travaillez avec des fichiers PDF, il est souvent nécessaire de mettre en surbrillance du texte ou des caractères, que ce soit à des fins académiques, de modification ou simplement pour améliorer la lisibilité. Imaginez que vous avez un beau document, mais que vous souhaitez mettre en valeur certaines parties. C’est là que la mise en surbrillance entre en jeu ! Dans ce didacticiel, nous allons découvrir comment mettre en surbrillance des caractères dans un fichier PDF à l’aide de la puissante bibliothèque Aspose.PDF pour .NET.

Prérequis

Avant de passer au code, assurons-nous que nous avons tout ce dont nous avons besoin. Voici ce dont vous aurez besoin :

  1. Un environnement de développement : ce didacticiel suppose que vous travaillez dans Visual Studio ou un IDE .NET similaire.
  2. Bibliothèque Aspose.PDF pour .NET : si vous ne l’avez pas déjà fait, vous pouveztéléchargez-le ici et ajoutez-le à votre projet.
  3. Connaissances de base de C# : une introduction à la programmation C# vous aidera à comprendre facilement l’implémentation.
  4. Un document PDF : vous devez disposer d’un exemple de fichier PDF prêt à être utilisé. Vous pouvez en créer un ou utiliser un document existant.

Importation de paquets

Pour commencer, nous devons importer les espaces de noms nécessaires. Pour ce faire, vous devrez les inclure en haut de votre fichier C# :

using System.IO;
using Aspose.Pdf;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Devices;
using Aspose.Pdf.Text;
using System;
using System.Drawing;

Ces packages sont essentiels pour créer, manipuler et traiter des documents PDF à l’aide de la bibliothèque Aspose.

Maintenant, décomposons le processus en étapes digestes pour mettre en évidence les caractères de votre PDF.

Étape 1 : Initialiser le document PDF

La première étape consiste à initialiser votre document PDF. Cela implique de charger le fichier PDF avec lequel vous allez travailler. Voici comment procéder :

string dataDir = "YOUR DOCUMENT DIRECTORY"; // Assurez-vous de définir le chemin correct.
Aspose.Pdf.Document pdfDocument = new Aspose.Pdf.Document(dataDir + "input.pdf");

Dans cet extrait, remplacezYOUR DOCUMENT DIRECTORY avec le chemin réel sur votre machine où se trouve votre fichier PDF d’entrée.Aspose.Pdf.Document la classe est instanciée pour charger votre PDF.

Étape 2 : Configurer le processus de rendu

Ensuite, nous devons préparer le processus de rendu de notre document. Cela est essentiel pour mettre en évidence avec précision les caractères de la page.

int resolution = 150; // Définissez la résolution pour la capture d'image.
using (MemoryStream ms = new MemoryStream())
{
    PdfConverter conv = new PdfConverter(pdfDocument);
    conv.Resolution = new Resolution(resolution, resolution);
    conv.GetNextImage(ms, System.Drawing.Imaging.ImageFormat.Png);
    Bitmap bmp = (Bitmap)Bitmap.FromStream(ms);

Nous définissons une résolution pour plus de clarté, permettant au texte d’être rendu correctement.PdfConvertertransforme les pages PDF en images afin que nous puissions dessiner dessus.

Étape 3 : Créer un objet graphique pour le dessin

Après avoir configuré le processus de dessin, nous devons créer un objet graphique dans lequel nous effectuerons notre mise en évidence :

using (System.Drawing.Graphics gr = System.Drawing.Graphics.FromImage(bmp))
{
    float scale = resolution / 72f; // Facteur d'échelle.
    gr.Transform = new System.Drawing.Drawing2D.Matrix(scale, 0, 0, -scale, 0, bmp.Height);

Ici, nous créons l’objet graphique à partir de l’image bitmap. La transformation permet d’ajuster le rendu pour correspondre correctement à la résolution requise.

Étape 4 : Parcourez chaque page et mettez en surbrillance le texte

Maintenant, parcourons chaque page du PDF et trouvons les fragments de texte que nous souhaitons mettre en évidence :

for (int i = 0; i < pdfDocument.Pages.Count; i++)
{
    Page page = pdfDocument.Pages[i + 1]; // Les pages sont indexées 1 dans Aspose.
    TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber(@"[\S]+");
    textFragmentAbsorber.TextSearchOptions.IsRegularExpressionUsed = true;
    page.Accept(textFragmentAbsorber);

Nous accédons à chaque page et recherchons tout le texte à l’aide duTextFragmentAbsorber . Le modèle d’expression régulière@"[\S]+" capture tous les caractères non-espaces.

Étape 5 : extraire des fragments de texte et les mettre en surbrillance

Il est maintenant temps d’extraire les fragments de texte et de les mettre en surbrillance. Ce processus consiste à dessiner des rectangles autour des caractères que nous souhaitons mettre en surbrillance :

TextFragmentCollection textFragmentCollection = textFragmentAbsorber.TextFragments;

foreach (TextFragment textFragment in textFragmentCollection)
{
    // Mettre en évidence la logique ici
    for (int segNum = 1; segNum <= textFragment.Segments.Count; segNum++)
    {
        TextSegment segment = textFragment.Segments[segNum];
        for (int charNum = 1; charNum <= segment.Characters.Count; charNum++)
        {
            CharInfo characterInfo = segment.Characters[charNum];
            gr.DrawRectangle(Pens.Black, 
                (float)characterInfo.Rectangle.LLX, 
                (float)characterInfo.Rectangle.LLY, 
                (float)characterInfo.Rectangle.Width, 
                (float)characterInfo.Rectangle.Height);
        }
    }
}

Nous parcourons chaque fragment de texte, ses segments et ses caractères individuels, en dessinant des rectangles autour d’eux à l’aide de l’objet graphique précédemment créé.

Étape 6 : Enregistrer l’image modifiée

Après avoir mis en surbrillance, vous devrez enregistrer l’image résultante en tant que nouveau fichier PNG :

dataDir = dataDir + "HighlightCharacterInPDF_out.png";
bmp.Save(dataDir, System.Drawing.Imaging.ImageFormat.Png);

Cette ligne enregistre votre image bitmap modifiée sous forme de fichier PNG dans le répertoire désigné.

Étape 7 : Terminez avec la gestion des exceptions

Enfin, c’est une bonne pratique d’envelopper votre code dans un bloc try-catch, en veillant à ce que nous gérons correctement toutes les erreurs inattendues :

catch (Exception ex)
{
    Console.WriteLine(ex.Message + "\nThis example will only work if you apply a valid Aspose License. You can purchase full license or get a 30-day temporary license from [here](https://buy.aspose.com/temporary-license/).");
}

Ce bloc détecte toutes les exceptions qui pourraient survenir pendant le processus et fournit des informations à l’utilisateur.

Conclusion

Et voilà ! Vous avez réussi à mettre en surbrillance des caractères dans un fichier PDF à l’aide d’Aspose.PDF pour .NET. Cette puissante bibliothèque ouvre la voie à des possibilités infinies en matière de manipulation de PDF, que vous travailliez avec des annotations, le remplissage de formulaires ou même la conversion de documents. Au fur et à mesure que vous progressez dans votre aventure avec Aspose, n’oubliez pas que la pratique est essentielle. Continuez à expérimenter différentes fonctionnalités et vous deviendrez rapidement un pro du PDF !

FAQ

Qu’est-ce qu’Aspose.PDF pour .NET ?

Aspose.PDF pour .NET est une bibliothèque qui permet de créer, de manipuler et de convertir des documents PDF par programmation dans des applications .NET.

Puis-je mettre en évidence plusieurs fragments de texte à la fois ?

Oui, le code fourni peut être adapté pour mettre en évidence plusieurs fragments en parcourant tout le texte du PDF.

Existe-t-il une version gratuite d’Aspose.PDF ?

Oui, Aspose propose un essai gratuit, vous pouvez donc tester la bibliothèque avant de l’acheter.

Ai-je besoin de licences pour utiliser Aspose.PDF ?

Oui, une licence valide est requise pour une utilisation commerciale, mais vous pouvez acquérir une licence temporaire de 30 jours pour les tests.

Où puis-je trouver plus de documentation ?

Vous pouvez vous référer à laDocumentation Aspose.PDF pour des informations plus détaillées sur la mise en œuvre et les fonctionnalités.

Bloc de texte caché dans le fichier PDF Paragraphes à plusieurs colonnes dans un fichier PDF