Jak dodawać i edytować adnotacje w plikach PDF w języku C

Jakie właściwości mogę ustawić dla adnotacji tekstowych?

Klasa TextAnnotation oferuje kilka właściwości do dostosowania poza wymienne podstawowe:

• Title: Tekst nagłówka adnotacji, zwykle wyświetlany w oknie adnotacji
• Contents: Główne ciało tekstu adnotacji
• X, Y: Współrzędne określające, gdzie ikona adnotacji pojawia się na stronie
• PageIndex: Numer strony zaczynający się od zera, gdzie powinna być umieszczona adnotacja
• Subject: Opcjonalna linia temat dla kategoryzacji adnotacji
• Icon: Wizualna reprezentacja adnotacji (np. Uwaga, Komentarz, Pomoc)
• Open: Czy adnotacja popup jest domyślnie otwarta

Te właściwości umożliwiają programistom tworzenie bogatych, kontekstowych adnotacji, które usprawniają komunikację w dokumentach. W przypadku zaawansowanych procesów obejmujących wiele typów dokumentów warto rozważyć konwersję plików RTF do formatu PDF lub konwersję plików Markdown do formatu PDF, aby zachować adnotacje w różnych formatach źródłowych.

Jak działają współrzędne w adnotacjach PDF?

Dlaczego miałbym edytować istniejące adnotacje?

Edycja adnotacji staje się niezbędna w procesach współpracy nad dokumentami, gdzie informacje zwrotne wymagają aktualizacji w oparciu o poprawki, niejasne komentarze wymagają wyjaśnienia, a adnotacje muszą zostać przeniesione w inne miejsce z powodu zmian w treści. Ta funkcja gwarantuje, że recenzje dokumentów pozostają aktualne i istotne przez cały cykl weryfikacji.

W środowiskach Enterprise edycja adnotacji często integruje się z procesami zatwierdzania, w których przełożeni mogą potrzebować zmodyfikować komentarze recenzentów przed ostatecznym zatwierdzeniem. Ponadto, gdy dokumenty są tłumaczone lub lokalizowane, adnotacje mogą wymagać aktualizacji w celu odzwierciedlenia zmian językowych lub dostosowań kulturowych. W takich sytuacjach obsługa UTF-8 i języków międzynarodowych przez IronPDF zapewnia prawidłowe wyświetlanie adnotacji w różnych językach i zestawach znaków.

Co dzieje się z innymi właściwościami dokumentu podczas edycji adnotacji?

Proces edycji zachowuje wszystkie pozostałe właściwości i treść dokumentu, zapewniając, że zmodyfikowana zostanie tylko określona adnotacja. Struktura dokumentu, formatowanie, zasoby osadzone i inne adnotacje pozostają niezmienione, co pozwala zachować integralność pliku PDF, umożliwiając jednocześnie ukierunkowane aktualizacje w odpowiedzi na konkretne uwagi recenzentów.

Takie selektywne podejście do edycji ma kluczowe znaczenie dla zachowania integralności dokumentu, zwłaszcza w branżach podlegających regulacjom, gdzie należy unikać fałszowania dokumentów. Proces ten zachowuje podpisy cyfrowe, pola formularzy, zakładki i wszystkie inne funkcje plików PDF. W przypadku dokumentów wymagających ścieżek audytu warto rozważyć wdrożenie śledzenia historii zmian wraz z modyfikacjami adnotacji.

Plik PDF z edytowaną adnotacją

Adnotacje w powyższym dokumencie PDF można wyświetlić w przeglądarce Chrome.

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak mogę usunąć pojedynczą adnotację?

: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")

Jak mogę usunąć wszystkie adnotacje jednocześnie?

Aby usunąć wszystkie adnotacje na danej stronie, użyj metody RemoveAllAnnotationsForPage i określ indeks strony. Jeśli chcesz usunąć wszystkie adnotacje w całym dokumencie, wywołaj metodę Clear na właściwości Annotations.

Ta funkcja masowego usuwania jest szczególnie przydatna podczas przygotowywania dokumentów do ostatecznej dystrybucji lub podczas wdrażania systemów wersjonowania dokumentów, w których konieczne jest usunięcie adnotacji z poprzednich cykli przeglądu. Rozważ połączenie tego z edycją metadanych w celu aktualizacji właściwości dokumentu i wskazania statusu recenzji. W przypadku przepływów pracy wymagających zdezynfekowanych dokumentów, eksploruj opcje [sanitacji PDF](https://ironpdf.com/how to sanitize-pdf/) w celu usunięcia wszelkich potencjalnie wrażliwych informacji, w tym adnotacji.

: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")

Kiedy należy używać funkcji zbiorczego usuwania adnotacji?

Usuwanie zbiorcze jest idealnym rozwiązaniem podczas finalizowania dokumentów do dystrybucji, tworzenia czystych wersji do celów archiwizacji lub wdrażania wersjonowania dokumentów, gdzie konieczne jest usunięcie adnotacji z poprzednich cykli przeglądu. Takie podejście pozwala zaoszczędzić czas w porównaniu z usuwaniem adnotacji pojedynczo i gwarantuje, że żadne komentarze recenzentów nie pozostaną przypadkowo w dokumentach produkcyjnych.

Ponadto masowe usuwanie jest niezbędne podczas przygotowywania dokumentów dla systemów przetwarzania automatycznego, które mogą nie obsługiwać adnotacji poprawnie, lub podczas konwersji plików PDF z adnotacjami do innych formatów. W środowiskach o wysokim poziomie bezpieczeństwa usunięcie wszystkich adnotacji przed dystrybucją zapobiega nieumyślnemu ujawnieniu wewnętrznych komentarzy recenzujących lub poufnych opinii, które nie były przeznaczone dla odbiorców zewnętrznych.

Jaka jest różnica między adnotacją linku a adnotacją tekstową?

TextAnnotation to "przypięta notatka": ikona komentarza, która wyświetla tekst po kliknięciu. LinkAnnotation to kontrola nawigacyjna, niewidoczny lub obramowany klikalny obszar, który przenosi czytelnika do strony docelowej. Oba dzielą kolekcję Annotations oraz te same operacje Add, RemoveAt, RemoveAllAnnotationsForPage i Clear, dzięki czemu można mieszać komentarze i linki nawigacyjne w tym samym dokumencie i nimi zarządzać.

Ponieważ LinkAnnotation kieruje na strony w tym samym pliku, uzupełnia funkcje konturów i zakładek IronPDF (które tworzą drzewo nawigacji paska bocznego widoku) oraz automatycznie generowana spis treści dla renderowania HTML do PDF. Użyj zakładek dla paska bocznego, funkcji TOC dla renderowanego HTML i LinkAnnotation, gdy potrzebujesz klikalnych punktów w istniejącym PDF.

Jak kontrolować, co widzi czytelnik w miejscu docelowym?

Właściwość DestinationType używa istniejącej enumy BookmarkDestinations do kontrolowania, jak strona docelowa jest wyświetlana po kliknięciu linku. Domyślnie jest BookmarkDestinations.Page, co dopasowuje całą stronę docelową w oknie. Inne wartości przewijają do pozycji, ustalają poziom powiększenia lub dopasowują określony prostokąt, używając współrzędnych DestinationTop, DestinationLeft, DestinationRight, DestinationBottom i 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")

Jak umiescic link nad istniejacym tekstem?

Aby nałożyć klikalny link na tekst, który już istnieje na stronie, wyodrębnij tekst za pomocą PdfPage.TextChunks i użyj BoundingBox dla każdego kawałka, aby dopasować rozmiar linku. Ponieważ współrzędne PDF pochodzą z dolnego-lewego rogu strony, przypisz BoundingBox.Bottom do Y, a nie BoundingBox.Top, co umieściłoby klikalny obszar nad widocznym tekstem. Ustaw Hidden = true, aby usunąć widoczną krawędź, tak aby link siedział niewidocznie nad renderowanym tekstem.

To jest podstawa do przekształcenia statycznego, drukowanego spisu treści w nawigowalny. Poniższy przykład skanuje stronę spisu treści, dopasowuje każdą pozycję na podstawie tekstu i nakłada niewidoczny LinkAnnotation, który przeskakuje do właściwej strony.

: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")

Czy mogę tworzyć linki "Wstecz na górę" lub linki na tej samej stronie?

Tak. Linki na tej samej stronie, gdzie pageIndex jest równe destinationPageIndex, są w pełni obsługiwane i to typowy sposób na budowanie przycisku "wstecz na górę". Połącz link na tej samej stronie z DestinationType = BookmarkDestinations.PageY i wysoką wartością DestinationTop, tak aby kliknięcie przewijało czytelnika na górę bieżącej strony. Dodaj ten sam link do dolnej części każdej strony, aby dać długim raportom jednolitą kontrolę powrotu na górę.

Dlaczego układy współrzędnych mają znaczenie dla adnotacji?

Współrzędne PDF wywodzące się z lewego dolnego rogu mogą powodować zamieszanie wśród programistów przyzwyczajonych do systemów współrzędnych z lewym górnym rogiem jako punktem początkowym. Nieprawidłowe obliczenia współrzędnych mogą spowodować umieszczenie adnotacji w nieoczekiwanych miejscach, potencjalnie zasłaniając ważne treści lub wykraczając poza obszar strony. Zawsze należy odpowiednio konwertować współrzędne podczas integracji z frameworkami UI lub systemami wprowadzania danych przez użytkownika.

Zrozumienie układu współrzędnych staje się jeszcze ważniejsze podczas wdrażania funkcji takich jak "kliknij, aby dodać adnotację" lub podczas konwersji współrzędnych ekranowych z interakcji użytkownika na współrzędne PDF. W przypadku złożonych wymagań dotyczących pozycjonowania warto rozważyć wykorzystanie funkcji okna wyświetlania i Zoomu IronPDF, aby zapewnić prawidłowe wyświetlanie adnotacji niezależnie od warunków wyświetlania.

Jak mogę zoptymalizować wydajność podczas dodawania wielu adnotacji?

W przypadku dodawania wielu adnotacji należy zgrupować operacje, dodając wszystkie adnotacje do kolekcji przed zapisaniem dokumentu. Takie podejście ogranicza operacje wejścia/wyjścia plików i znacznie poprawia wydajność, zwłaszcza w przypadku dużych plików PDF lub podczas przetwarzania wielu dokumentów po kolei. Rozważ wdrożenie wskaźników postępu, aby zapewnić użytkownikom lepsze wrażenia podczas operacji zbiorczych.

// 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")

Aby uzyskać jeszcze lepszą wydajność w scenariuszach o dużej objętości, warto rozważyć zastosowanie przetwarzania asynchronicznego lub technik wielowątkowości w celu równoległego przetwarzania operacji adnotacji.

Co należy wziąć pod uwagę w kwestii kompatybilności między przeglądarkami?

Różne przeglądarki plików PDF mogą wyświetlać adnotacje z różnymi stylami ikon, zachowaniami wyskakujących okienek lub specyficznym rozmieszczeniem. Zawsze testuj swoje pliki PDF z adnotacjami w popularnych przeglądarkach, takich jak Adobe Acrobat, Chrome, Edge i mobilne czytniki PDF, aby upewnić się, że adnotacje wyświetlają się poprawnie i działają na wszystkich platformach, z których mogą korzystać Twoi użytkownicy.

Niektóre przeglądarki mogą nie obsługiwać wszystkich typów adnotacji lub wyświetlać je w inny sposób. Aby zapewnić maksymalną kompatybilność, należy stosować standardowe typy adnotacji i unikać funkcji specyficznych dla danej przeglądarki. Podczas wdrażania w określonych środowiskach, takich jak Azure lub AWS, należy przetestować adnotacje w domyślnych przeglądarkach plików PDF środowiska docelowego, aby zapewnić spójne działanie.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Zapoznaj się z naszą stroną z samouczkami tutaj: Edytuj pliki PDF