Niewidoczna adnotacja w pliku PDF

Wstęp

Czy kiedykolwiek chciałeś dodać adnotacje do plików PDF, które pozostaną niewidoczne, ale skuteczne? Niezależnie od tego, czy chcesz dodać notatki do celów drukowania, czy chcesz zostawić ukrytą wiadomość w dokumentach, niewidoczne adnotacje mogą być niezwykle przydatne. W tym samouczku przeprowadzimy Cię przez proces tworzenia niewidocznej adnotacji w pliku PDF przy użyciu Aspose.PDF dla .NET. Ta potężna biblioteka .NET pozwala z łatwością manipulować dokumentami PDF, a do końca tego przewodnika opanujesz sztukę dodawania niewidocznych adnotacji do plików PDF jak profesjonalista!

Wymagania wstępne

Zanim przejdziemy do szczegółów, upewnijmy się, że masz wszystko, czego potrzebujesz:

  • Aspose.PDF dla .NET: Upewnij się, że masz zainstalowaną bibliotekę Aspose.PDF. Możesz ją pobrać zTutaj.
  • Środowisko programistyczne .NET: Powinieneś mieć zainstalowany program Visual Studio lub inne preferowane środowisko programistyczne .NET.
  • Podstawowa znajomość języka C#: Znajomość składni i programowania w języku C# jest niezbędna.
  • Ważna licencja lub bezpłatna wersja próbna: Jeśli nie masz licencji, możesz uzyskać tymczasowąTutaj lub skorzystaj z bezpłatnej wersji próbnej.

Importuj pakiety

Na początek musisz zaimportować niezbędne przestrzenie nazw. Te przestrzenie nazw zapewnią Ci dostęp do klas i metod wymaganych do pracy z dokumentami PDF w Aspose.PDF dla .NET.

using System.IO;
using Aspose.Pdf.Annotations;
using Aspose.Pdf;
using System;

Teraz, gdy omówiliśmy już kwestie wstępne, możemy podzielić proces dodawania niewidocznej adnotacji do dokumentu PDF na mniejsze, łatwiejsze do wykonania kroki.

Krok 1: Skonfiguruj katalog dokumentów

Najpierw musisz określić ścieżkę do katalogu dokumentów, w którym znajduje się plik PDF wejściowy. Ta ścieżka zostanie użyta do załadowania dokumentu PDF do programu.

// Ścieżka do katalogu dokumentów.
string dataDir = "YOUR DOCUMENT DIRECTORY";

TendataDirzmienna przechowuje ścieżkę do katalogu, w którym przechowywane są pliki PDF. Upewnij się, że zastąpisz"YOUR DOCUMENT DIRECTORY" z rzeczywistą ścieżką na Twoim komputerze.

Krok 2: Załaduj dokument PDF

Następnie załadujemy dokument PDF do naszego programu. To jest ten dokument, do którego dodamy niewidoczną adnotację.

// Otwórz dokument
Document doc = new Document(dataDir + "input.pdf");

Tutaj używamyDocument klasę z biblioteki Aspose.PDF, aby otworzyć plik PDF o nazwieinput.pdf. Upewnij się, że ten plik istnieje w katalogu określonym w poprzednim kroku.

Krok 3: Utwórz niewidoczną adnotację

Teraz nadchodzi ekscytująca część — tworzenie niewidocznej adnotacji. UżyjemyFreeTextAnnotation Klasa umożliwiająca dodanie adnotacji w postaci dowolnego tekstu do pierwszej strony dokumentu PDF.

FreeTextAnnotation annotation = new FreeTextAnnotation(doc.Pages[1], new Aspose.Pdf.Rectangle(50, 600, 250, 650), new DefaultAppearance("Helvetica", 16, System.Drawing.Color.Red));
annotation.Contents = "ABCDEFG";
annotation.Characteristics.Border = System.Drawing.Color.Red;
annotation.Flags = AnnotationFlags.Print | AnnotationFlags.NoView;
doc.Pages[1].Annotations.Add(annotation);
  • Tworzymy nowyFreeTextAnnotation i określ stronę (doc.Pages[1] ) gdzie należy go dodać.Rectangle Klasa definiuje obszar na stronie, w którym zostanie umieszczona adnotacja.
  • TenDefaultAppearance Klasa służy do ustawiania czcionki, rozmiaru czcionki i koloru adnotacji. W tym przykładzie wybraliśmy czcionkę „Helvetica”, rozmiar 16 i kolor czerwony.
  • TenContentsWłaściwość przechowuje tekst adnotacji, tutaj ustawiony na"ABCDEFG".
  • TenCharacteristics.Border Właściwość definiuje kolor obramowania adnotacji, ponownie ustawiony na czerwony.
  • TenFlags nieruchomość obejmujeAnnotationFlags.Print aby zapewnić widoczność adnotacji po wydrukowaniu dokumentu,AnnotationFlags.NoView aby uczynić go niewidocznym podczas normalnego oglądania.
  • Na koniec dodajemy adnotację do pierwszej strony dokumentu PDF za pomocąAnnotations.Add metoda.

Krok 4: Zapisz zaktualizowany dokument PDF

Po dodaniu adnotacji następnym krokiem jest zapisanie zaktualizowanego dokumentu PDF.

dataDir = dataDir + "InvisibleAnnotation_out.pdf";
// Zapisz plik wyjściowy
doc.Save(dataDir);

ModyfikujemydataDir zmienna określająca nazwę pliku wyjściowego,"InvisibleAnnotation_out.pdf" . TenSave Metoda ta zapisuje następnie zaktualizowany dokument PDF z niewidoczną adnotacją w określonym katalogu.

Krok 5: Potwierdź zakończenie procesu

Na koniec, zawsze dobrą praktyką jest zapewnienie potwierdzenia, że proces zakończył się pomyślnie. Dodamy w tym celu proste wyjście konsoli.

Console.WriteLine("\nAnnotation invisible successfully.\nFile saved at " + dataDir);

Ten wiersz wyświetla na konsoli komunikat potwierdzający, informujący, że niewidoczna adnotacja została pomyślnie dodana i wskazujący lokalizację zapisanego pliku.

Wniosek

I masz to! Udało Ci się dodać niewidoczną adnotację do pliku PDF za pomocą Aspose.PDF dla .NET. Ten samouczek przeprowadził Cię przez każdy krok, od konfiguracji środowiska do zapisania ostatecznego dokumentu. Niezależnie od tego, czy dodajesz ukryte wiadomości, czy adnotacje do celów drukowania, niewidoczne adnotacje są potężną funkcją, którą możesz łatwo zaimplementować za pomocą Aspose.PDF dla .NET. Miłego kodowania!

Najczęściej zadawane pytania

Czy mogę ponownie wyświetlić adnotację?

Tak, poprzez usunięcieAnnotationFlags.NoView flagę, możesz sprawić, że adnotacja będzie widoczna podczas normalnego przeglądania.

Jakie inne typy adnotacji mogę dodać za pomocą Aspose.PDF?

Aspose.PDF obsługuje różne adnotacje, w tym adnotacje tekstowe, linkowe, podświetlane i stemplowane.

Czy można modyfikować adnotację po jej dodaniu?

Tak, możesz modyfikować właściwości adnotacji nawet po jej dodaniu do dokumentu.

Jak mogę dodać wiele adnotacji do tego samego dokumentu?

Po prostu powtórz proces tworzenia adnotacji dla każdej adnotacji, którą chcesz dodać. Każda adnotacja może zostać dodana do tej samej lub innej strony.

Co zrobić, jeśli mój dokument PDF ma wiele stron?

Numer strony można określić podczas tworzenia adnotacji, zmieniającdoc.Pages[1] do żądanego indeksu strony.

Pobierz zasób adnotacji Szerokość linii adnotacji lnk