Créer des éléments de structure

Le code source C# suivant utilise Aspose.PDF pour .NET pour créer des éléments de structure. Suivez les étapes ci-dessous pour comprendre le fonctionnement du code.

Étape 1 : Importez les bibliothèques nécessaires

using Aspose.Pdf;

Étape 2 : Définissez le répertoire de vos documents

string dataDir = "YOUR DOCUMENTS DIRECTORY";

Assurez-vous de spécifier le chemin correct vers votre répertoire de documents.

Étape 3 : Créer un document PDF

Document document = new Document();

Nous créons un nouvel objet Document qui représente le document PDF.

Étape 4 : Faire fonctionner le contenu avec TaggedPdf

ITaggedContent taggedContent = document.TaggedContent;

Nous récupérons le contenu balisé du document PDF. Cela nous permettra de manipuler des éléments structurels.

Étape 5 : Définir le titre et la langue du document

taggedContent.SetTitle("Tagged PDF document");
taggedContent.SetLanguage("fr-FR");

Nous définissons le titre et la langue du document PDF balisé. Cela améliore l’accessibilité du document.

Étape 6 : Créer des éléments de regroupement

PartElement partElement = taggedContent.CreatePartElement();
ArtElement artElement = taggedContent.CreateArtElement();
SectElement sectElement = taggedContent.CreateSectElement();
DivElement divElement = taggedContent.CreateDivElement();
BlockQuoteElement blockQuoteElement = taggedContent.CreateBlockQuoteElement();
CaptionElement captionElement = taggedContent.CreateCaptionElement();
TOCElement tocElement = taggedContent.CreateTOCElement();
TOCIElement tociElement = taggedContent.CreateTOCIElement();
IndexElement indexElement = taggedContent.CreateIndexElement();
NonStructElement nonStructElement = taggedContent.CreateNonStructElement();
PrivateElement privateElement = taggedContent.CreatePrivateElement();

Nous créons différents éléments structurels pour regrouper le contenu dans le document PDF.

Étape 7 : Créer des éléments de structure de paragraphe

ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
HeaderElement headerElement = taggedContent.CreateHeaderElement();
HeaderElement h1Element = taggedContent.CreateHeaderElement(1);

Nous créons des éléments structurels au niveau des blocs pour les paragraphes et les titres. L’exemple ci-dessus montre la création d’un en-tête de niveau 1.

Étape 8 : Créer des éléments de structure de niveau en ligne

SpanElement spanElement = taggedContent.CreateSpanElement();
QuoteElement quoteElement = taggedContent.CreateQuoteElement();
NoteElement noteElement = taggedContent.CreateNoteElement();

Nous créons des éléments de structure de niveau en ligne pour les parties de texte qui apparaissent à l’intérieur d’un paragraphe ou d’un titre.

Étape 9 : Créer des éléments de structure d’illustration

FigureElement figureElement = taggedContent.CreateFigureElement();
FormulaElement formulaElement = taggedContent.CreateFormulaElement();

Nous créons des éléments structurels pour les illustrations et les formules mathématiques présentes dans le document.

Étape 10 : Enregistrez le document PDF balisé

document.Save(dataDir + "StructureElements.pdf");

Nous enregistrons le document PDF balisé avec les éléments de structure créés.

Exemple de code source pour créer des éléments de structure à l’aide d’Aspose.PDF pour .NET


// Le chemin d'accès au répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// Créer un document PDF
Document document = new Document();
// Obtenez du contenu pour travailler avec TaggedPdf
ITaggedContent taggedContent = document.TaggedContent;
// Définir le titre et la langue du document
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");
// Créer des éléments de regroupement
PartElement partElement = taggedContent.CreatePartElement();
ArtElement artElement = taggedContent.CreateArtElement();
SectElement sectElement = taggedContent.CreateSectElement();
DivElement divElement = taggedContent.CreateDivElement();
BlockQuoteElement blockQuoteElement = taggedContent.CreateBlockQuoteElement();
CaptionElement captionElement = taggedContent.CreateCaptionElement();
TOCElement tocElement = taggedContent.CreateTOCElement();
TOCIElement tociElement = taggedContent.CreateTOCIElement();
IndexElement indexElement = taggedContent.CreateIndexElement();
NonStructElement nonStructElement = taggedContent.CreateNonStructElement();
PrivateElement privateElement = taggedContent.CreatePrivateElement();
// Créer des éléments de structure au niveau des blocs de texte
ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
HeaderElement headerElement = taggedContent.CreateHeaderElement();
HeaderElement h1Element = taggedContent.CreateHeaderElement(1);
// Créer des éléments de structure de texte au niveau en ligne
SpanElement spanElement = taggedContent.CreateSpanElement();
QuoteElement quoteElement = taggedContent.CreateQuoteElement();
NoteElement noteElement = taggedContent.CreateNoteElement();
// Créer des éléments de structure d'illustration
FigureElement figureElement = taggedContent.CreateFigureElement();
FormulaElement formulaElement = taggedContent.CreateFormulaElement();
// Les méthodes sont en cours de développement
ListElement listElement = taggedContent.CreateListElement();
TableElement tableElement = taggedContent.CreateTableElement();
ReferenceElement referenceElement = taggedContent.CreateReferenceElement();
BibEntryElement bibEntryElement = taggedContent.CreateBibEntryElement();
CodeElement codeElement = taggedContent.CreateCodeElement();
LinkElement linkElement = taggedContent.CreateLinkElement();
AnnotElement annotElement = taggedContent.CreateAnnotElement();
RubyElement rubyElement = taggedContent.CreateRubyElement();
WarichuElement warichuElement = taggedContent.CreateWarichuElement();
FormElement formElement = taggedContent.CreateFormElement();
// Enregistrer le document PDF balisé
document.Save(dataDir + "StructureElements.pdf");

Conclusion

Dans ce didacticiel, nous avons appris à utiliser Aspose.PDF pour .NET pour créer des éléments de structure dans un document PDF balisé. Les éléments structurels contribuent à améliorer l’accessibilité des documents et à organiser le contenu de manière significative. Vous pouvez désormais utiliser ces connaissances pour créer des documents PDF structurés et faciles à parcourir.

FAQ

Q : Quel est le but de créer des éléments de structure dans un document PDF à l’aide d’Aspose.PDF pour .NET ?

: La création d’éléments de structure dans un document PDF à l’aide d’Aspose.PDF pour .NET améliore l’accessibilité et l’organisation du contenu du document. Les éléments de structure fournissent une structure hiérarchique qui améliore la navigation, la sémantique et la compatibilité avec les technologies d’assistance.

Q : Comment le code C# fourni crée-t-il des éléments de structure dans un document PDF ?

R : L’exemple de code montre comment créer différents types d’éléments de structure, notamment des éléments de regroupement (tels que des parties, des sections et des div), des éléments de niveau bloc (tels que des paragraphes et des titres), des éléments de niveau en ligne (span, quote, note). ) et des éléments artistiques (tels que des figures et des formules). Ces éléments de structure aident à organiser le contenu.

Q : Pourquoi est-il important de définir le titre et la langue du document à l’aide du`SetTitle` and `SetLanguage` methods?

A : Définir le titre et la langue du document à l’aide duSetTitle etSetLanguageLes méthodes améliorent l’accessibilité et la sémantique des documents. Le titre fournit une brève description de l’objectif du document, tandis que l’attribut de langue améliore le rendu et l’accessibilité spécifiques à la langue.

Q : Comment regrouper des éléments, tels que`PartElement` and `SectElement`, contribute to the structure of the PDF document?

R : Le regroupement d’éléments crée une structure hiérarchique au sein du document PDF, vous permettant d’organiser et de regrouper logiquement le contenu associé. Cela améliore la navigation et fournit une structure claire aux utilisateurs.

Q : Que sont les éléments de structure au niveau bloc et au niveau en ligne, et en quoi diffèrent-ils ?

R : Les éléments de structure au niveau bloc représentent des blocs de contenu plus grands, tels que des paragraphes et des titres, tandis que les éléments de niveau en ligne représentent des parties de texte dans un paragraphe ou un titre, telles que des travées, des citations et des notes. Ils aident à définir la hiérarchie et les relations entre les contenus.

Q : Comment les éléments de structure des œuvres d’art, comme`FigureElement` and `FormulaElement`, contribute to the document?

R : Les éléments de structure de l’illustration vous permettent d’ajouter des illustrations, des figures et des formules mathématiques au document. Ils fournissent une manière structurée d’inclure du contenu visuel et mathématique.

Q : Puis-je utiliser des techniques similaires pour créer d’autres types d’éléments de structure, comme des listes, des tableaux ou des annotations ?

R : Oui, vous pouvez utiliser des techniques similaires pour créer d’autres types d’éléments de structure tels que des listes, des tableaux, des annotations, des références, etc. Aspose.PDF propose une large gamme de méthodes de création d’éléments de structure.

Q : Comment l’enregistrement du document PDF balisé à l’aide du`Save` method ensure the preservation of structure elements?

R : LeSave La méthode enregistre le document PDF avec les éléments de structure créés, garantissant que la structure hiérarchique et sémantique du document est préservée pour l’accessibilité et la navigation.

Q : Quels avantages les éléments de structure apportent-ils aux documents PDF en termes d’accessibilité et de compatibilité avec les technologies d’assistance ?

R : Les éléments de structure améliorent l’accessibilité en fournissant une structure et une sémantique significatives au document. Cela permet aux technologies d’assistance telles que les lecteurs d’écran d’interpréter et de transmettre plus efficacement le contenu du document aux utilisateurs handicapés.

Q : Comment puis-je personnaliser et combiner davantage différents types d’éléments de structure dans mes documents PDF ?

R : Vous pouvez combiner et personnaliser des éléments de structure en utilisant les méthodes de création appropriées fournies par Aspose.PDF. Expérimentez avec différents éléments et leurs propriétés pour créer un document PDF bien structuré et organisé.

Créer un PDF avec du texte balisé Créer une arborescence d'éléments de structure