Προσθήκη ετικέτας εικόνας σε υπάρχον PDF

Εισαγωγή

Σε αυτό το σεμινάριο, θα σας καθοδηγήσουμε στον τρόπο προσθήκης ετικετών σε μια εικόνα σε ένα υπάρχον PDF χρησιμοποιώντας το Aspose.PDF για .NET. Μέχρι το τέλος αυτού του οδηγού, θα μπορείτε να ορίσετε εναλλακτικό κείμενο για εικόνες, να προσαρμόσετε τα χαρακτηριστικά διάταξης και να διασφαλίσετε ότι το PDF σας συμμορφώνεται με τα πρότυπα προσβασιμότητας.

Προαπαιτούμενα

Πριν βουτήξουμε, ας δούμε τι θα χρειαστείτε για να ξεκινήσετε:

• Aspose.PDF για .NET: Βεβαιωθείτε ότι έχετε κατεβάσει και εγκαταστήσει την πιο πρόσφατη έκδοση του Aspose.PDF για .NET.Κατεβάστε εδώ.
• .NET Framework: Βεβαιωθείτε ότι έχετε ρυθμίσει ένα περιβάλλον ανάπτυξης .NET όπως το Visual Studio.
• Βασική κατανόηση της δομής PDF: Εξοικείωση με στοιχεία δομής PDF, όπως παραγράφους, εκτάσεις, πίνακες και εικόνες.
• Μια έγκυρη άδεια χρήσης: Μπορείτε είτε να αγοράσετε μια άδειαεδώ ή χρησιμοποιήστε ένα προσωρινόεδώ.

Εισαγωγή πακέτων

Για να ξεκινήσετε την κωδικοποίηση, πρέπει να εισαγάγετε τους βασικούς χώρους ονομάτων από το Aspose.PDF για .NET. Αυτά θα σας δώσουν πρόσβαση στις απαραίτητες κλάσεις και μεθόδους για να χειριστείτε το έγγραφο PDF.

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Τώρα που έχουμε ορίσει το στάδιο, ας αναλύσουμε τη διαδικασία προσθήκης ετικετών σε μια εικόνα σε πολλά βήματα.

Βήμα 1: Φορτώστε το υπάρχον έγγραφο PDF

Το πρώτο βήμα είναι να φορτώσετε το αρχείο PDF με το οποίο θέλετε να εργαστείτε. Αυτό μπορεί να είναι οποιοδήποτε αρχείο PDF με μια εικόνα που θέλετε να προσθέσετε ετικέτα.

// Η διαδρομή προς τον κατάλογο εγγράφων.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string inFile = dataDir + "TH.pdf";
string outFile = dataDir + "TH_out.pdf";
string logFile = dataDir + "TH_out.xml";

// Ανοίξτε το έγγραφο
Document document = new Document(inFile);

• Αντικαθιστώ"YOUR DOCUMENT DIRECTORY" με την πραγματική διαδρομή προς το αρχείο σας.
• ΟDocument class σάς επιτρέπει να φορτώσετε ένα υπάρχον PDF. Θα τροποποιήσετε αυτό το PDF για να προσθέσετε ετικέτα στην εικόνα.

Βήμα 2: Πρόσβαση στο περιεχόμενο με ετικέτα και στο στοιχείο δομής ρίζας

Αφού ανοίξετε το PDF, το επόμενο βήμα είναι να αποκτήσετε πρόσβαση στο περιεχόμενο με ετικέτα και να προσδιορίσετε το στοιχείο της δομής ρίζας. Αυτό είναι κρίσιμο, καθώς σας επιτρέπει να πλοηγηθείτε στα στοιχεία του PDF και να κάνετε τροποποιήσεις.

// Λάβετε ετικέτα περιεχομένου και στοιχείο δομής ρίζας
ITaggedContent taggedContent = document.TaggedContent;
StructureElement rootElement = taggedContent.RootElement;

• TaggedContent παρέχει πρόσβαση στα δομημένα στοιχεία του PDF.
• ΟRootElement είναι το κορυφαίο στοιχείο δομής, από το οποίο μπορείτε να μεταβείτε σε άλλα στοιχεία όπως παραγράφους, πίνακες και εικόνες.

Βήμα 3: Ορίστε τον τίτλο για το έγγραφο PDF με ετικέτα

Η προσθήκη ενός τίτλου στο έγγραφο PDF με ετικέτα διασφαλίζει ότι το έγγραφό σας έχει τη σωστή ετικέτα, κάτι που είναι χρήσιμο για την προσβασιμότητα και τη συμμόρφωση με PDF/UA.

// Ορίστε τίτλο για το έγγραφο PDF με ετικέτα
taggedContent.SetTitle("Document with images");

• Ο ορισμός ενός τίτλου για το PDF με ετικέτα βελτιώνει την προσβασιμότητα και βελτιώνει τη σαφήνεια των εγγράφων για προγράμματα ανάγνωσης οθόνης και βοηθητικές τεχνολογίες.

Βήμα 4: Βρείτε και προσθέστε ετικέτα στην εικόνα

Τώρα, ας βρούμε το στοιχείο εικόνας (αναφέρεται ως αFigureElement στο Aspose.PDF), ορίστε ένα εναλλακτικό κείμενο για αυτό και διαμορφώστε τα χαρακτηριστικά διάταξής του.

// Κάντε βρόχο σε όλα τα στοιχεία του σχήματος (εικόνες) και ορίστε εναλλακτικά χαρακτηριστικά κειμένου και διάταξης
foreach (FigureElement figureElement in rootElement.FindElements<FigureElement>(true))
{
    // Ορίστε εναλλακτικό κείμενο για το σχήμα
    figureElement.AlternativeText = "Figure alternative text (technique 2)";
    
    // Δημιουργία και ορισμός χαρακτηριστικού BBox (πλαίσιο οριοθέτησης)
    StructureAttribute bboxAttribute = new StructureAttribute(AttributeKey.BBox);
    bboxAttribute.SetRectangleValue(new Aspose.Pdf.Rectangle(0.0, 0.0, 100.0, 100.0));
    
    // Ορίστε χαρακτηριστικά διάταξης για το σχήμα
    StructureAttributes figureLayoutAttributes = figureElement.Attributes.GetAttributes(AttributeOwnerStandard.Layout);
    figureLayoutAttributes.SetAttribute(bboxAttribute);
}

• Αυτός ο κώδικας περιστρέφεται σε όλα ταFigureElement αντικείμενα στη δομή ρίζας, τα οποία αντιπροσωπεύουν εικόνες.
• Ορίζει το εναλλακτικό κείμενο για προσβασιμότητα (οι αναγνώστες οθόνης θα το χρησιμοποιήσουν για να περιγράψουν την εικόνα).
• Το πλαίσιο οριοθέτησης (BBoxκαθορίζει τις συντεταγμένες για τη διάταξη της εικόνας, διασφαλίζοντας ότι εμφανίζεται σωστά στο έγγραφο.

Βήμα 5: Τροποποίηση στοιχείων Span εντός του πίνακα

Σε ορισμένες περιπτώσεις, μπορεί να χρειαστεί να τροποποιήσετε στοιχεία span μέσα σε έναν πίνακα. Εδώ, θα δείξουμε πώς να βρείτε έναSpanElement και μετακινήστε το σε μια παράγραφο.

// Βρείτε τα στοιχεία του πίνακα, του εύρους και της παραγράφου
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];

// Μετακινήστε το στοιχείο span στην παράγραφο
spanElement.ChangeParentElement(paragraph);

• Εδώ, εντοπίζουμε τοTableElement, SpanElement , καιParagraphElement εντός του PDF.
• Χρησιμοποιώντας τοChangeParentElement μεταφέρουμε το εύρος στην παράγραφο για να διασφαλίσουμε τη σωστή προσθήκη ετικετών και δομή.

Βήμα 6: Αποθηκεύστε το έγγραφο και επικυρώστε τη συμμόρφωση PDF/UA

Μόλις γίνουν όλες οι αλλαγές, το τελευταίο βήμα είναι να αποθηκεύσετε το ενημερωμένο PDF και να ελέγξετε εάν συμμορφώνεται με τα πρότυπα PDF/UA.

// Αποθηκεύστε το ενημερωμένο έγγραφο PDF
document.Save(outFile);

// Επικύρωση συμμόρφωσης PDF/UA
document = new Document(outFile);
bool isPdfUaCompliance = document.Validate(logFile, PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));

• ΟValidate Η μέθοδος ελέγχει το έγγραφο PDF σε σχέση με τα πρότυπα PDF/UA και καταγράφει τα αποτελέσματα.
• Η διασφάλιση της συμμόρφωσης συμβάλλει στη βελτίωση της προσβασιμότητας και στην κάλυψη των κανονιστικών απαιτήσεων για τη δημοσίευση εγγράφων.

Σύναψη

Σε αυτό το σεμινάριο, σας δείξαμε πώς να προσθέτετε ετικέτες σε εικόνες σε ένα υπάρχον PDF χρησιμοποιώντας το Aspose.PDF για .NET. Ορίζοντας εναλλακτικό κείμενο, προσαρμόζοντας τα χαρακτηριστικά διάταξης και επικυρώνοντας το έγγραφο για συμμόρφωση με PDF/UA, μπορείτε να διασφαλίσετε ότι τα PDF σας είναι προσβάσιμα και πληρούν τα σύγχρονα πρότυπα. Το Aspose.PDF διευκολύνει την εργασία με δομημένα στοιχεία, δίνοντάς σας τον έλεγχο της διάταξης και της προσβασιμότητας του εγγράφου σας.

Συχνές ερωτήσεις

Σε τι χρησιμοποιείται το Aspose.PDF για .NET;

Το Aspose.PDF για .NET είναι μια ισχυρή βιβλιοθήκη που χρησιμοποιείται για τη δημιουργία, την επεξεργασία και τον χειρισμό εγγράφων PDF μέσω προγραμματισμού σε περιβάλλον .NET.

Πώς μπορώ να διασφαλίσω τη συμμόρφωση PDF/UA;

Μπορείτε να χρησιμοποιήσετε το Aspose.PDF’sValidate μέθοδος ελέγχου για τη συμμόρφωση PDF/UA μετά την πραγματοποίηση τροποποιήσεων στο έγγραφο.

Τι είναι το εναλλακτικό κείμενο σε αρχεία PDF;

Το εναλλακτικό κείμενο είναι μια περιγραφή που προστίθεται σε εικόνες σε αρχεία PDF για τη βελτίωση της προσβασιμότητας, ειδικά για χρήστες που βασίζονται σε προγράμματα ανάγνωσης οθόνης.

Μπορώ να χειριστώ πίνακες και διαστήματα σε ένα PDF με το Aspose.PDF;

Ναι, το Aspose.PDF σάς επιτρέπει να χειρίζεστε πίνακες, εκτάσεις και άλλα δομημένα στοιχεία σε ένα έγγραφο PDF.

Πού μπορώ να κατεβάσω το Aspose.PDF για .NET;

Μπορείτε να κάνετε λήψη της πιο πρόσφατης έκδοσης του Aspose.PDF για .NETεδώ.