Oznacz obraz w istniejącym pliku PDF
W tym szczegółowym samouczku przeprowadzimy Cię krok po kroku przez dostarczony kod źródłowy C#, aby oznaczyć obraz w istniejącym pliku PDF za pomocą Aspose.PDF dla .NET. Postępuj zgodnie z poniższymi instrukcjami, aby dowiedzieć się, jak dodać znaczniki do obrazu w pliku PDF.
Krok 1: Konfigurowanie środowiska
Zanim zaczniesz, upewnij się, że skonfigurowałeś środowisko programistyczne do korzystania z Aspose.PDF dla .NET. Obejmuje to instalację biblioteki Aspose.PDF i skonfigurowanie projektu tak, aby się do niej odwoływał.
Krok 2: Otwórz istniejący dokument PDF
tym kroku otworzymy istniejący dokument PDF przy użyciu Aspose.PDF.
// Ścieżka do katalogu dokumentów.
string dataDir = "YOUR DOCUMENTS DIRECTORY";
// Ścieżki plików wejściowych i wyjściowych
string inFile = dataDir + "TH.pdf";
string outFile = dataDir + "TH_out.pdf";
string logFile = dataDir + "TH_out.xml";
// Otwórz dokument
Document document = new Document(inFile);
Otworzyliśmy istniejący dokument PDF za pomocą Aspose.PDF.
Krok 3: Uzyskaj oznakowaną treść i element struktury głównej
Teraz otrzymamy oznaczoną treść dokumentu PDF i odpowiadający jej element struktury głównej.
// Pobierz otagowaną treść i element struktury głównej
ITaggedContent taggedContent = document.TaggedContent;
StructureElement rootElement = taggedContent.RootElement;
Otrzymaliśmy oznaczoną treść dokumentu PDF i odpowiadający jej element struktury głównej.
Krok 4: Ustawianie tytułu oznaczonego dokumentu PDF
Teraz ustawmy tytuł otagowanego dokumentu PDF.
// Zdefiniuj tytuł oznaczonego dokumentu PDF
taggedContent.SetTitle("Document with images");
Ustawiliśmy tytuł dla oznaczonego dokumentu PDF.
Krok 5: Przypisz teksty alternatywne i obwiednię do obrazu
Teraz dla każdego elementu obrazu przypiszemy tekst alternatywny i obwiednię.
foreach(FigureElement figureElement in rootElement.FindElements<FigureElement>(true))
{
// Przypisz tekst alternatywny do obrazu
figureElement.AlternativeText = "Alternative text for image (technique 2)";
// Utwórz i przypisz obwiednię (bbox)
StructureAttribute bboxAttribute = new StructureAttribute(AttributeKey.BBox);
bboxAttribute.SetRectangleValue(new Rectangle(0.0, 0.0, 100.0, 100.0));
StructureAttributes figureLayoutAttributes = figureElement.Attributes.GetAttributes(AttributeOwnerStandard.Layout);
figureLayoutAttributes.SetAttribute(bboxAttribute);
}
Do każdego elementu obrazu w dokumencie PDF przypisaliśmy tekst alternatywny i obwiednię.
Krok 6: Przeniesienie elementu Span do akapitu
Teraz przenieśmy element Span do akapitu.
// Przenieś element Span do akapitu (znajdź nieprawidłowy zakres i akapit w pierwszym TD)
TableElement tableElement = rootElement.FindElements<TableElement>(true)[0];
SpanElement spanElement = tableElement.FindElements<SpanElement>(true)[0];
TableTDElement firstTdElement = tableElement.FindElements<TableTDElement>(true)[0];
ParagraphElement paragraph = firstTdElement.FindElements<ParagraphElement>(true)[0];
// Przesuń element Rozpiętość w akapicie
spanElement.ChangeParentElement(paragraph);
Przenieśliśmy element Span do określonego akapitu.
Krok 7: Zapisanie zmodyfikowanego dokumentu PDF
Teraz, gdy dokonaliśmy niezbędnych zmian, zapiszemy zmodyfikowany dokument PDF.
// Zapisz dokument PDF
document. Save(outFile);
Zapisaliśmy zmodyfikowany dokument PDF we wskazanym katalogu.
Przykładowy kod źródłowy dla obrazu znacznika w istniejącym pliku PDF przy użyciu Aspose.PDF dla .NET
// Ścieżka do katalogu dokumentów.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string inFile = dataDir + "TH.pdf";
string outFile = dataDir + "TH_out.pdf";
string logFile = dataDir + "TH_out.xml";
// Otwórz dokument
Document document = new Document(inFile);
// Pobiera oznakowaną treść i element struktury głównej
ITaggedContent taggedContent = document.TaggedContent;
StructureElement rootElement = taggedContent.RootElement;
// Ustaw tytuł oznaczonego dokumentu PDF
taggedContent.SetTitle("Document with images");
foreach (FigureElement figureElement in rootElement.FindElements<FigureElement>(true))
{
// Ustaw tekst alternatywny dla rysunku
figureElement.AlternativeText = "Figure alternative text (technique 2)";
// Utwórz i ustaw atrybut BBox
StructureAttribute bboxAttribute = new StructureAttribute(AttributeKey.BBox);
bboxAttribute.SetRectangleValue(new Rectangle(0.0, 0.0, 100.0, 100.0));
StructureAttributes figureLayoutAttributes = figureElement.Attributes.GetAttributes(AttributeOwnerStandard.Layout);
figureLayoutAttributes.SetAttribute(bboxAttribute);
}
// Przenieś element rozpiętości do akapitu (znajdź niewłaściwy rozpiętość i akapit w pierwszym TD)
TableElement tableElement = rootElement.FindElements<TableElement>(true)[0];
SpanElement spanElement = tableElement.FindElements<SpanElement>(true)[0];
TableTDElement firstTdElement = tableElement.FindElements<TableTDElement>(true)[0];
ParagraphElement paragraph = firstTdElement.FindElements<ParagraphElement>(true)[0];
// Przenieś element rozpiętości do akapitu
spanElement.ChangeParentElement(paragraph);
// Zapisz dokument
document.Save(outFile);
//Sprawdzanie zgodności wychodzącego dokumentu z PDF/UA
document = new Document(outFile);
bool isPdfUaCompliance = document.Validate(logFile, PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
Wniosek
W tym samouczku nauczyliśmy się, jak oznaczać obraz w istniejącym pliku PDF za pomocą Aspose.PDF dla .NET. Możesz teraz używać Aspose.PDF do dodawania tagów i edytowania obrazów w dokumentach PDF.
Często zadawane pytania
P: Jaki jest główny cel tego samouczka dotyczącego oznaczania obrazów w istniejącym pliku PDF przy użyciu Aspose.PDF dla .NET?
Odp.: Głównym celem tego samouczka jest poprowadzenie Cię przez proces zaznaczania obrazu w istniejącym dokumencie PDF przy użyciu Aspose.PDF dla .NET. Samouczek zawiera instrukcje krok po kroku i przykłady kodu źródłowego języka C#, które pomogą Ci zrozumieć, jak przypisywać alternatywny tekst i ramki ograniczające do obrazów, przenosić elementy w dokumencie i dodawać tagi do obrazów.
P: Jakie są wymagania wstępne, aby skorzystać z tego samouczka dotyczącego oznaczania obrazów w pliku PDF przy użyciu Aspose.PDF dla .NET?
O: Zanim zaczniesz, upewnij się, że skonfigurowałeś środowisko programistyczne do korzystania z Aspose.PDF dla .NET. Obejmuje to zainstalowanie biblioteki Aspose.PDF i skonfigurowanie projektu tak, aby się do niej odwoływał.
P: Jak mogę otworzyć istniejący dokument PDF i uzyskać dostęp do jego oznaczonej zawartości przy użyciu Aspose.PDF dla .NET?
Odp.: W samouczku znajdują się przykłady kodu źródłowego C#, które pokazują, jak otworzyć istniejący dokument PDF przy użyciu Aspose.PDF dla .NET i uzyskać dostęp do jego oznaczonej zawartości w celu dalszej manipulacji.
P: Jaki jest cel przypisywania alternatywnego tekstu i ramek ograniczających do obrazów w dokumencie PDF?
Odp.: Przypisanie alternatywnego tekstu i ramek ograniczających do obrazów zwiększa dostępność, zapewniając tekst opisowy dla obrazów oraz definiując ich układ i położenie w dokumencie. Informacje te są kluczowe dla czytników ekranu i innych technologii wspomagających.
P: Jak mogę ustawić tytuł oznaczonego dokumentu PDF przy użyciu Aspose.PDF dla .NET?
Odp.: Samouczek zawiera przykłady kodu źródłowego C#, które ilustrują, jak ustawić tytuł oznakowanego dokumentu PDF przy użyciu Aspose.PDF dla .NET.
P: Na czym polega proces przenoszenia elementów w dokumencie PDF?
Odp.: Przenoszenie elementów w dokumencie PDF wiąże się ze zmianą elementu nadrzędnego określonego elementu. W tym samouczku dowiesz się, jak przenieść element Span do określonego elementu Akapit w tabeli.
P: Jak zapisać zmodyfikowany dokument PDF po dodaniu tagów i dokonaniu edycji obrazów?
O: Po dodaniu tagów, przypisaniu tekstu alternatywnego, ustawieniu ramek ograniczających i wprowadzeniu zmian w dokumencie PDF możesz użyć dostarczonych przykładów kodu źródłowego C#, aby zapisać zmodyfikowany dokument PDF za pomocąSave()
metoda.
P: Jaki jest cel przykładowego kodu źródłowego udostępnionego w samouczku?
O: Przykładowy kod źródłowy służy jako praktyczne odniesienie do wdrażania tagowania i manipulacji obrazami przy użyciu Aspose.PDF dla .NET. Możesz użyć tego kodu jako punktu wyjścia i zmodyfikować go tak, aby odpowiadał Twoim konkretnym wymaganiom.
P: Czy mogę zastosować te techniki do innych typów elementów w dokumencie PDF, a nie tylko do obrazów?
O: Tak, techniki zademonstrowane w tym samouczku można dostosować do pracy z różnymi typami elementów w dokumencie PDF. Możesz zastosować podobne zasady do oznaczania i manipulowania innymi elementami, takimi jak tekst, tabele i inne.
P: Jak mogę sprawdzić zgodność zmodyfikowanego dokumentu PDF z formatem PDF/UA?
O: W samouczku znajdują się przykłady kodu źródłowego języka C#, które pokazują, jak sprawdzić zgodność zmodyfikowanego dokumentu PDF z formatem PDF/UA za pomocąValidate()
metodę i wygenerowanie raportu XML.
P: Jakie inne funkcje oferuje Aspose.PDF dla .NET do pracy z dokumentami PDF?
Odp.: Aspose.PDF dla .NET oferuje szeroką gamę funkcji do pracy z dokumentami PDF, w tym manipulację tekstem, wstawianie obrazów, tworzenie tabel, zarządzanie polami formularzy, podpisy cyfrowe, adnotacje i inne. Aby uzyskać dalsze informacje, zapoznaj się z oficjalną dokumentacją i zasobami.