Comment ajouter et modifier des annotations PDF en C#;

Quelles sont les propriétés que je peux définir pour les annotations de texte ?

La classe TextAnnotation offre plusieurs propriétés pour la personnalisation au-delà des propriétés de base :

• Title : Le texte d'en-tête de l'annotation, généralement affiché dans la fenêtre contextuelle de l'annotation
• Contents : Le texte principal du corps de l'annotation
• X, Y : Les coordonnées spécifiant où l'icône de l'annotation apparaît sur la page
• PageIndex : Le numéro de page basé sur zéro où l'annotation devrait être placée
• Subject : Une ligne d'objet optionnelle pour catégoriser les annotations
• Icon : La représentation visuelle de l'annotation (par exemple, Note, Commentaire, Aide)
• Open : Si la fenêtre contextuelle de l'annotation est ouverte par défaut

Ces propriétés permettent aux développeurs de créer des annotations riches et contextuelles qui améliorent la communication des documents. Pour les flux de travail avancés impliquant plusieurs types de documents, envisagez d'explorer la conversion RTF vers PDF ou la conversion Markdown vers PDF pour conserver les annotations dans différents formats sources.

Comment fonctionnent les coordonnées dans les annotations PDF?

Pourquoi aurais-je besoin de modifier des annotations existantes ?

L'édition d'annotations devient essentielle dans les flux de travail collaboratifs de documents où le retour d'information doit être mis à jour en fonction des révisions, où des clarifications sont nécessaires pour les commentaires ambigus, ou où les annotations doivent être repositionnées en raison de changements de contenu. Cette capacité garantit que les révisions de documents restent actuelles et pertinentes tout au long du cycle de révision.

Dans les environnements d'entreprise, l'édition d'annotations s'intègre souvent à des flux de travail d'approbation où les superviseurs peuvent avoir besoin de modifier les commentaires des réviseurs avant l'approbation finale. En outre, lorsque les documents sont traduits ou localisés, les annotations peuvent nécessiter des mises à jour pour refléter les changements de langue ou les adaptations culturelles. Pour de tels scénarios, le UTF-8 et la prise en charge des langues internationales d'IronPDF garantissent que les annotations s'affichent correctement dans différentes langues et jeux de caractères.

Qu'advient-il des autres propriétés du document lorsque l'on modifie des annotations ?

Le processus d'édition conserve toutes les autres propriétés et le contenu du document, en veillant à ce que seule l'annotation spécifiée soit modifiée. La structure du document, le formatage, les ressources intégrées et les autres annotations restent inchangés, ce qui préserve l'intégrité de votre PDF tout en permettant des mises à jour ciblées en fonction des commentaires de révision spécifiques.

Cette approche sélective de l'édition est cruciale pour maintenir l'intégrité des documents, en particulier dans les secteurs réglementés où la falsification des documents doit être évitée. Le processus préserve les signatures numériques, les champs de formulaire, les signets et toutes les autres fonctionnalités des PDF. Pour les documents nécessitant des pistes d'audit, envisagez de mettre en place un suivi de l'historique des révisions parallèlement aux modifications des annotations.

PDF avec une annotation modifiée

L'annotation dans le document PDF ci-dessus peut être consultée avec le navigateur Chrome.

---

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Comment supprimer une seule annotation?

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-single-annotation.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1);

pdf.SaveAs("removeSingleAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1)

pdf.SaveAs("removeSingleAnnotation.pdf")

Comment supprimer toutes les annotations en une seule fois ?

Pour supprimer toutes les annotations sur une page particulière, utilisez la méthode RemoveAllAnnotationsForPage et spécifiez l'index de la page. Si vous souhaitez supprimer toutes les annotations dans l'ensemble du document, appelez la méthode Clear sur la propriété Annotations.

Cette capacité de suppression en bloc est particulièrement utile lors de la préparation de documents en vue de leur distribution finale ou lors de la mise en œuvre de systèmes de gestion des versions de documents dans lesquels les annotations des cycles de révision précédents doivent être supprimées. Envisagez de combiner cette opération avec l'édition de métadonnées pour mettre à jour les propriétés du document et indiquer le statut de révision. Pour les flux de travail nécessitant des documents assainis, explorez les options de [sanitization PDF](https://ironpdf.com/how to sanitize-pdf/) pour supprimer toutes les informations potentiellement sensibles, y compris les annotations.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-all-annotation.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0);

// Remove all annotaions on the document
pdf.Annotations.Clear();

pdf.SaveAs("removeAllAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0)

' Remove all annotaions on the document
pdf.Annotations.Clear()

pdf.SaveAs("removeAllAnnotation.pdf")

Quand utiliser la suppression d'annotations en bloc?

La suppression en bloc est idéale pour finaliser des documents en vue de leur distribution, pour créer des versions propres à des fins d'archivage ou pour mettre en œuvre un système de gestion des versions de documents dans lequel les annotations des cycles de révision précédents doivent être supprimées. Cette approche permet de gagner du temps par rapport à la suppression individuelle des annotations et garantit qu'aucun commentaire de révision ne subsiste accidentellement dans les documents de production.

En outre, la suppression en bloc est essentielle lors de la préparation de documents pour des systèmes de traitement automatisés qui peuvent ne pas gérer correctement les annotations, ou lors de la conversion de PDF annotés dans d'autres formats. Dans les environnements hautement sécurisés, la suppression de toutes les annotations avant la distribution permet d'éviter la divulgation involontaire de commentaires de révision internes ou d'informations sensibles qui n'étaient pas destinées à un public externe.

Quelle est la différence entre une annotation de lien et une annotation de texte ?

Un TextAnnotation est une 'note autocollante' : une icône de commentaire qui affiche du texte lorsqu'elle est cliquée. Un LinkAnnotation est un contrôle de navigation, une région cliquable invisible ou bordée qui fait sauter le lecteur à une page cible. Les deux partagent la collection Annotations et les mêmes opérations Add, RemoveAt, RemoveAllAnnotationsForPage et Clear, vous pouvez donc mélanger des commentaires et des liens de navigation dans le même document et les gérer ensemble.

Parce que LinkAnnotation cible des pages dans le même fichier, il complète les signets et les signets d'IronPDF (qui construisent l'arborescence de navigation de la barre latérale du visualiseur) et la fonctionnalité table des matières générée automatiquement pour le rendu HTML en PDF. Utilisez les signets pour la barre latérale, la fonctionnalité TOC pour le HTML rendu, et LinkAnnotation lorsque vous avez besoin de points d'accès cliquables sur un PDF existant.

Comment contrôler ce que le lecteur voit à la destination ?

La propriété DestinationType utilise l'énumération existante BookmarkDestinations pour contrôler comment la page cible est affichée lorsque le lien est cliqué. Par défaut, c'est BookmarkDestinations.Page, qui adapte toute la page de destination dans la fenêtre. D'autres valeurs défilent jusqu'à une position, définissent un niveau de zoom ou adaptent un rectangle spécifique, en utilisant les coordonnées DestinationTop, DestinationLeft, DestinationRight, DestinationBottom et DestinationZoom.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-link-destination-types.cs

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;

PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// 1. Scroll to a specific vertical position on the destination page (full width shown)
LinkAnnotation scrollLink = new LinkAnnotation(0, 2)
{
    X = 72, Y = 680, Width = 300, Height = 16,
    DestinationType = BookmarkDestinations.PageY,
    DestinationTop = 400        // scroll so y=400 sits at the top of the view
};
pdf.Annotations.Add(scrollLink);

// 2. Jump to a position AND set the zoom level
LinkAnnotation zoomLink = new LinkAnnotation(0, 3, "Zoom to figure")
{
    X = 72, Y = 650, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageZoom,
    DestinationLeft = 100,
    DestinationTop = 500,
    DestinationZoom = 150       // 150% zoom; use 0 to inherit the current zoom
};
pdf.Annotations.Add(zoomLink);

// 3. Fit a specific rectangle on the destination page
LinkAnnotation rectLink = new LinkAnnotation(0, 4)
{
    X = 72, Y = 620, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageRect,
    DestinationLeft = 50,
    DestinationBottom = 100,
    DestinationRight = 550,
    DestinationTop = 700
};
pdf.Annotations.Add(rectLink);

pdf.SaveAs("link-destinations.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks

Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' 1. Scroll to a specific vertical position on the destination page (full width shown)
Dim scrollLink As New LinkAnnotation(0, 2) With {
    .X = 72, .Y = 680, .Width = 300, .Height = 16,
    .DestinationType = BookmarkDestinations.PageY,
    .DestinationTop = 400        ' scroll so y=400 sits at the top of the view
}
pdf.Annotations.Add(scrollLink)

' 2. Jump to a position AND set the zoom level
Dim zoomLink As New LinkAnnotation(0, 3, "Zoom to figure") With {
    .X = 72, .Y = 650, .Width = 200, .Height = 16,
    .DestinationType = BookmarkDestinations.PageZoom,
    .DestinationLeft = 100,
    .DestinationTop = 500,
    .DestinationZoom = 150       ' 150% zoom; use 0 to inherit the current zoom
}
pdf.Annotations.Add(zoomLink)

' 3. Fit a specific rectangle on the destination page
Dim rectLink As New LinkAnnotation(0, 4) With {
    .X = 72, .Y = 620, .Width = 200, .Height = 16,
    .DestinationType = BookmarkDestinations.PageRect,
    .DestinationLeft = 50,
    .DestinationBottom = 100,
    .DestinationRight = 550,
    .DestinationTop = 700
}
pdf.Annotations.Add(rectLink)

pdf.SaveAs("link-destinations.pdf")

Comment positionner un lien sur un texte existant ?

Pour superposer un lien cliquable sur du texte qui existe déjà sur une page, extrayez le texte avec PdfPage.TextChunks et utilisez la BoundingBox de chaque morceau pour dimensionner le lien. Étant donné que les coordonnées PDF commencent en bas à gauche de la page, assignez BoundingBox.Bottom à Y, pas BoundingBox.Top, ce qui placerait la zone cliquable au-dessus du texte visible. Définissez Hidden = true pour faire disparaître la bordure visible afin que le lien se situe invisiblement sur le texte rendu.

Ceci est la base pour transformer une table des matières statique et imprimée en une table des matières navigable. L'exemple ci-dessous scanne la page TOC, correspond à chaque entrée par son texte, et superpose un LinkAnnotation invisible qui saute à la bonne page.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-link-toc.cs

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;
using System;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("report-with-toc.pdf");

// Zero-based index of the page that holds the table-of-contents text
int tocPageIndex = 1;

// Map each TOC entry's leading text to the page index it should jump to
var tocEntries = new Dictionary<string, int>
{
    { "Introduction", 2 },
    { "Methodology",  4 },
    { "Results",      6 },
    { "Conclusion",   9 },
};

// Walk the text chunks on the TOC page and overlay a clickable link on each match
foreach (var chunk in pdf.Pages[tocPageIndex].TextChunks)
{
    string text = chunk.Contents.Trim();

    foreach (var entry in tocEntries)
    {
        if (!text.StartsWith(entry.Key)) continue;

        var box = chunk.BoundingBox;
        pdf.Annotations.Add(new LinkAnnotation(tocPageIndex, entry.Value)
        {
            X = (int)box.Left,
            Y = (int)box.Bottom,                       // Bottom, NOT Top (PDF origin is bottom-left)
            Width = (int)Math.Max(box.Width, 400),
            Height = (int)Math.Abs(box.Top - box.Bottom),
            DestinationType = BookmarkDestinations.PageY,
            DestinationTop = 792,                      // top of a US Letter page
            Hidden = true                              // invisible overlay on the existing TOC text
        });
        break;
    }
}

pdf.SaveAs("clickable-toc.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks
Imports System
Imports System.Collections.Generic

Dim pdf As PdfDocument = PdfDocument.FromFile("report-with-toc.pdf")

' Zero-based index of the page that holds the table-of-contents text
Dim tocPageIndex As Integer = 1

' Map each TOC entry's leading text to the page index it should jump to
Dim tocEntries As New Dictionary(Of String, Integer) From {
    {"Introduction", 2},
    {"Methodology", 4},
    {"Results", 6},
    {"Conclusion", 9}
}

' Walk the text chunks on the TOC page and overlay a clickable link on each match
For Each chunk In pdf.Pages(tocPageIndex).TextChunks
    Dim text As String = chunk.Contents.Trim()

    For Each entry In tocEntries
        If Not text.StartsWith(entry.Key) Then Continue For

        Dim box = chunk.BoundingBox
        pdf.Annotations.Add(New LinkAnnotation(tocPageIndex, entry.Value) With {
            .X = CInt(box.Left),
            .Y = CInt(box.Bottom),                       ' Bottom, NOT Top (PDF origin is bottom-left)
            .Width = CInt(Math.Max(box.Width, 400)),
            .Height = CInt(Math.Abs(box.Top - box.Bottom)),
            .DestinationType = BookmarkDestinations.PageY,
            .DestinationTop = 792,                      ' top of a US Letter page
            .Hidden = True                              ' invisible overlay on the existing TOC text
        })
        Exit For
    Next
Next

pdf.SaveAs("clickable-toc.pdf")

Puis-je créer des liens "back-to-top" ou sur la même page ?

Oui. Les liens de même page, où pageIndex égale destinationPageIndex, sont entièrement pris en charge et constituent le moyen habituel de construire un bouton 'retour en haut'. Combinez un lien de même page avec DestinationType = BookmarkDestinations.PageY et une valeur DestinationTop élevée pour que le clic fasse défiler le lecteur jusqu'en haut de la page actuelle. Ajoutez le même lien au pied de chaque page pour donner aux longs rapports un contrôle de retour en haut cohérent.

Pourquoi les systèmes de coordonnées sont-ils importants pour les annotations ?

Les coordonnées PDF provenant du coin inférieur gauche peuvent être source de confusion pour les développeurs habitués aux systèmes d'origine haut-gauche. Des calculs de coordonnées incorrects peuvent placer des annotations à des endroits inattendus, ce qui risque de masquer un contenu important ou d'apparaître en dehors de la page. Il convient de toujours convertir les coordonnées de manière appropriée lors de l'intégration avec des cadres d'interface utilisateur ou des systèmes d'entrée utilisateur.

La compréhension du système de coordonnées devient encore plus critique lors de la mise en œuvre de fonctionnalités telles que le clic pour annoter ou lors de la conversion des coordonnées de l'écran provenant des interactions de l'utilisateur en coordonnées PDF. Pour les exigences de positionnement complexes, pensez à utiliser les fonctionnalités viewport et zoom d'IronPDF pour vous assurer que les annotations apparaissent correctement quelles que soient les conditions de visualisation.

Comment optimiser les performances lors de l'ajout de plusieurs annotations ?

Lorsque vous ajoutez plusieurs annotations, effectuez vos opérations par lots en ajoutant toutes les annotations à la collection avant d'enregistrer le document. Cette approche réduit les opérations d'entrée/sortie de fichiers et améliore considérablement les performances, en particulier avec les PDF volumineux ou lors du traitement de plusieurs documents à la suite. Envisagez de mettre en place des indicateurs de progression pour améliorer l'expérience de l'utilisateur lors des opérations de masse.

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

Imports System.Collections.Generic

' Example of batch annotation processing
Dim annotations As New List(Of TextAnnotation)()
For i As Integer = 0 To 99
    annotations.Add(New TextAnnotation(0) With {
        .Title = $"Note {i}",
        .Contents = $"Content for note {i}",
        .X = 50 + (i * 10),
        .Y = 700 - (i * 20)
    })
Next

' Add all annotations at once
For Each annotation In annotations
    pdf.Annotations.Add(annotation)
Next

' Save once after all additions
pdf.SaveAs("batch-annotated.pdf")

Pour des performances encore meilleures dans des scénarios à volume élevé, envisagez d'utiliser le traitement asynchrone ou les techniques de multithreading pour traiter les opérations d'annotation en parallèle.

Qu'est-ce qu'il faut prendre en compte pour la compatibilité inter-viseurs?

Différentes visionneuses PDF peuvent rendre les annotations avec des styles d'icônes, des comportements de popup ou des bizarreries de positionnement différents. Testez toujours vos PDF annotés dans des visionneuses populaires comme Adobe Acrobat, Chrome, Edge et les lecteurs PDF mobiles pour vous assurer que les annotations apparaissent correctement et restent fonctionnelles sur toutes les plateformes que vos utilisateurs pourraient employer.

Certaines visionneuses peuvent ne pas prendre en charge tous les types d'annotations ou les afficher différemment. Pour une compatibilité maximale, il convient de s'en tenir aux types d'annotations standard et d'éviter de s'appuyer sur des fonctionnalités propres à la visionneuse. Lors du déploiement dans des environnements spécifiques tels que Azure ou AWS, testez les annotations dans les visionneuses PDF par défaut de l'environnement cible afin de garantir un comportement cohérent.

Prêt à voir ce que vous pouvez faire d'autre? Consultez notre page de tutoriel ici : Modifier les PDFs