Annotations PDFDocuments Word

Comment ajouter des annotations à un PDF en utilisant C# .NET

À l’ère numérique d’aujourd’hui, les PDF sont devenus un format populaire pour le partage d’informations, de documents et de rapports. Cependant, la simple visualisation d’un PDF peut ne pas suffire à de nombreux utilisateurs. Parfois, les utilisateurs peuvent vouloir mettre en surbrillance ou ajouter des notes à des parties spécifiques du PDF pour fournir un contexte ou des commentaires supplémentaires. Heureusement, il existe plusieurs annotateurs PDF gratuits qui permettent aux utilisateurs d’ajouter facilement des commentaires, de surligner du texte, etc. Cependant, dans cet article, nous allons explorer comment utiliser l’API REST pour prendre en charge les annotations PDF et vous montrer comment mettre en surbrillance, commenter et ajouter des notes à vos documents PDF.

API REST pour l’annotation PDF

Aspose.PDF Cloud fournit une solution complète et facile à utiliser pour ajouter des annotations aux documents PDF par programme. Avec Aspose.PDF Cloud, vous pouvez ajouter différents types d’annotations aux documents PDF, notamment du texte, des images, des tampons et diverses annotations de balisage. Vous pouvez également modifier les annotations existantes, telles que la position, la taille, la couleur ou toute autre propriété.

Les annotations prises en charge incluent le texte, le cercle, le polygone, la polyligne, la ligne, le carré, le texte libre, le surlignage, le soulignement, le squiggly, le barré, le caret, l’encre, le lien, la fenêtre contextuelle, le fichier joint, le son, le film, l’écran, le widget, le filigrane, TrapNet, PrinterMark, Caviardage, Tampon, RichMedia et PDF3D.

Maintenant, afin d’ajouter le SDK dans votre projet, veuillez rechercher Aspose.PDF-Cloud dans le gestionnaire de packages NuGet et cliquez sur le bouton Ajouter un package. La prochaine étape importante consiste à enregistrer un compte sur le tableau de bord Cloud et à obtenir vos informations d’identification personnelles. Veuillez consulter le guide Quick Start pour plus de détails.

Ajouter des commentaires au PDF en utilisant C#

Examinons l’extrait de code C# .NET utilisé pour ajouter une annotation à un document PDF.

// Pour des exemples complets et des fichiers de données, veuillez consulter 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Obtenez les informations d'identification du client à partir de https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// créer un objet de PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);

// créer un objet List contenant FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // spécifier la région rectangulaire contenant FreeTextAnnotation
    // définir également les détails de formatage du texte
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))
    {
    // Contenu à afficher dans FreeTextAnnotation
    Contents = "Confidential !",
    Color = new Aspose.Pdf.Cloud.Sdk.Model.Color(0, 0, 0, 0),
    Id = "id1",
    Name = "Test Free Text",                    
    Flags = new List<AnnotationFlags> {AnnotationFlags.Default},
    HorizontalAlignment = HorizontalAlignment.Center,
    Intent = FreeTextIntent.FreeTextTypeWriter,
    RichText = "Rich Text",
    Subject = "Text Box Subj",
    ZIndex = 1,
    Justification = Justification.Center,
    Title = "Title",
    PageIndex = 1                     
    }
};
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Maintenant, comprenons l’extrait de code plus en détail.

PdfApi api = new PdfApi(clientSecret, clientID);

Créez une instance de la classe PdfApi qui prend les informations d’identification du client comme arguments dans son constructeur.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Comme l’API prend en charge la capacité d’ajouter une ou plusieurs annotations de type similaire en même temps, nous devons donc créer un objet List de type FreeTextAnnnotation.

new FreeTextAnnotation(
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))

Créez un objet de FreeTextAnnotation où nous définissons la région rectangulaire pour les détails d’annotation et de formatage du texte.

Contents = "Confidential !"

Ici, nous définissons le contenu de FreeTextAnnotation.

var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Appelez l’API REST pour ajouter FreeTextAnnotation sur la première page du document PDF déjà disponible dans le stockage Cloud.

Vous trouverez ci-dessous les valeurs possibles qui peuvent être attribuées aux propriétés utilisées dans l’extrait de code ci-dessus.

  • AnnotationFlags - Les valeurs prises en charge peuvent être [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • Rotation - Angle de rotation du texte. Les valeurs possibles peuvent être [None, on90, on180, on270].
  • AnnotationFlags - Un ensemble d’indicateurs spécifiant diverses caractéristiques de l’annotation. La valeur possible peut être [Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents].
  • FreeTextIntent - Énumère les intentions de l’annotation de texte libre. Les valeurs possibles peuvent être [ Undefined, FreeTextCallout, FreeTextTypeWriter].

Ajouter une annotation de texte libre au PDF à l’aide des commandes cURL

L’utilisation de commandes cURL pour appeler l’API Aspose.PDF Cloud est une bonne approche pour répondre à cette exigence. Il est également bon que vous connaissiez les outils de ligne de commande ou que vous préfériez les utiliser. Ainsi, avec l’outil de ligne de commande cURL, vous pouvez effectuer des requêtes HTTP et effectuer diverses opérations concernant le traitement des fichiers PDF.

Désormais, pour ajouter des annotations à un document PDF à l’aide des commandes cURL, nous devons d’abord générer un jeton d’authentification en envoyant une demande au point de terminaison du jeton avec votre App SID et votre clé d’application. Veuillez exécuter la commande suivante pour générer le accessToken.

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

Une fois le accessToken généré, veuillez exécuter la commande suivante qui ajoute le FreeTextAnnotation au document PDF. Le fichier PDF annoté est ensuite mis à jour sur le stockage Cloud.

curl -v "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/freetext" \
-X POST \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "[  {        \"Color\": {      \"A\": 0,      \"R\": 0,      \"G\": 0,      \"B\": 0    },    \"Contents\": \"Confidential !\",    \"Modified\": \"01/05/2023 12:00:00.000 PM\",    \"Id\": \"id0\",    \"Flags\": [      \"Default\"    ],    \"Name\": \"comment\",    \"Rect\": {      \"LLX\": 100,      \"LLY\": 800,      \"URX\": 350,      \"URY\": 830    },    \"PageIndex\": 0,    \"ZIndex\": 1,    \"HorizontalAlignment\": \"Center\",    \"VerticalAlignment\": \"Center\",    \"CreationDate\": \"03/05/2023 16:00:00.000 PM\",    \"Subject\": \"Subj.\",    \"Title\": \"Main Heading\",    \"RichText\": \"Hello world...\",    \"Justification\": \"Left\",    \"Intent\": \"FreeTextTypeWriter\",    \"Rotate\": \"None\",    \"TextStyle\": {      \"FontSize\": 26,      \"Font\": \"Arial\",      \"ForegroundColor\": {        \"A\": 10,        \"R\": 10,        \"G\": 100,        \"B\": 120      },      \"BackgroundColor\": {        \"A\": 0,        \"R\": 0,        \"G\": 50,        \"B\": 80      }    }  }]"

Remplacez {inputPDF} par le nom du fichier PDF d’entrée déjà disponible sur le stockage Cloud, {accessToken} par le jeton d’accès JWT généré ci-dessus.

Aperçu des annotations PDF

Image : - Aperçu de l’annotation de texte libre dans le fichier PDF.

Le document PDF utilisé dans l’exemple ci-dessus peut être téléchargé depuis ce lien.

Conclusion

En conclusion, l’ajout d’annotations aux PDF peut grandement améliorer leur utilité et leur fonctionnalité. Que vous cherchiez à mettre en évidence du texte important, à ajouter des commentaires ou à prendre des notes directement dans le document, Aspose.PDF Cloud est un choix incroyable pour y parvenir. Nous avons également appris que les commandes Aspose.PDF Cloud SDK pour .NET et cURL offrent des solutions puissantes pour annoter les PDF, vous donnant la possibilité de créer des flux de travail personnalisés et des processus d’automatisation. Par conséquent, avec ces outils, vous pouvez rapidement et facilement ajouter des annotations aux PDF, tout en gagnant du temps et en augmentant la productivité.

Liens utiles

Articles Liés

Nous vous recommandons vivement de parcourir les blogs suivants :