Criar elementos estruturais

O código-fonte C# a seguir usa Aspose.PDF for .NET para criar elementos de estrutura. Siga as etapas abaixo para entender como o código funciona.

Passo 1: Importe as bibliotecas necessárias

using Aspose.Pdf;

Passo 2: Defina o diretório dos seus documentos

string dataDir = "YOUR DOCUMENTS DIRECTORY";

Certifique-se de especificar o caminho correto para o diretório de documentos.

Passo 3: Crie um documento PDF

Document document = new Document();

Criamos um novo objeto Document que representa o documento PDF.

Etapa 4: faça o conteúdo funcionar com TaggedPdf

ITaggedContent taggedContent = document.TaggedContent;

Recuperamos o conteúdo marcado do documento PDF. Isso nos permitirá manipular elementos estruturais.

Etapa 5: definir o título e o idioma do documento

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

Definimos o título e o idioma do documento PDF marcado. Isso melhora a acessibilidade do documento.

Etapa 6: criar elementos de agrupamento

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();

Criamos diferentes elementos estruturais para agrupar o conteúdo do documento PDF.

Etapa 7: criar elementos de estrutura de parágrafo

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

Criamos elementos estruturais em nível de bloco para parágrafos e títulos. O exemplo acima mostra a criação de um cabeçalho de nível 1.

Etapa 8: Criar elementos de estrutura de nível embutido

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

Criamos elementos de estrutura de nível embutido para as partes do texto que aparecem dentro de um parágrafo ou título.

Etapa 9: Crie elementos de estrutura de arte

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

Criamos elementos estruturais para as ilustrações e fórmulas matemáticas presentes no documento.

Passo 10: Salve o documento PDF marcado

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

Salvamos o documento PDF marcado com os elementos da estrutura criada.

Exemplo de código-fonte para criar elementos de estrutura usando Aspose.PDF para .NET


// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// Criar documento PDF
Document document = new Document();
// Obtenha conteúdo para trabalhar com TaggedPdf
ITaggedContent taggedContent = document.TaggedContent;
// Definir título e idioma para Documnet
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");
// Criar elementos de agrupamento
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();
// Criar elementos de estrutura em nível de bloco de texto
ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
HeaderElement headerElement = taggedContent.CreateHeaderElement();
HeaderElement h1Element = taggedContent.CreateHeaderElement(1);
// Criar elementos de estrutura de nível embutido de texto
SpanElement spanElement = taggedContent.CreateSpanElement();
QuoteElement quoteElement = taggedContent.CreateQuoteElement();
NoteElement noteElement = taggedContent.CreateNoteElement();
// Criar elementos de estrutura de ilustração
FigureElement figureElement = taggedContent.CreateFigureElement();
FormulaElement formulaElement = taggedContent.CreateFormulaElement();
// Métodos estão em desenvolvimento
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();
// Salvar documento PDF marcado
document.Save(dataDir + "StructureElements.pdf");

Conclusão

Neste tutorial, aprendemos como usar Aspose.PDF for .NET para criar elementos de estrutura em um documento PDF marcado. Os elementos estruturais ajudam a melhorar a acessibilidade dos documentos e a organizar o conteúdo de uma forma significativa. Agora você pode usar esse conhecimento para criar documentos PDF estruturados e fáceis de navegar.

Perguntas frequentes

P: Qual é o propósito de criar elementos estruturais em um documento PDF usando Aspose.PDF for .NET?

R: A criação de elementos estruturais em um documento PDF usando Aspose.PDF for .NET melhora a acessibilidade e a organização do conteúdo do documento. Os elementos estruturais fornecem uma estrutura hierárquica que melhora a navegação, a semântica e a compatibilidade com tecnologias assistivas.

P: Como o código C# fornecido cria elementos de estrutura em um documento PDF?

R: O exemplo de código demonstra como criar vários tipos de elementos de estrutura, incluindo elementos de agrupamento (como partes, seções e divs), elementos de nível de bloco (como parágrafos e títulos), elementos de nível embutido (span, quote, note ) e elementos de arte (como figuras e fórmulas). Esses elementos de estrutura ajudam a organizar o conteúdo.

P: Por que é importante definir o título e o idioma do documento usando o`SetTitle` and `SetLanguage` methods?

R: Definir o título e o idioma do documento usando oSetTitle eSetLanguagemétodos melhoram a acessibilidade e a semântica dos documentos. O título fornece uma breve descrição da finalidade do documento, enquanto o atributo idioma aprimora a renderização e a acessibilidade específicas do idioma.

P: Como agrupar elementos, como`PartElement` and `SectElement`, contribute to the structure of the PDF document?

R: O agrupamento de elementos cria uma estrutura hierárquica dentro do documento PDF, permitindo organizar e agrupar logicamente o conteúdo relacionado. Isso aprimora a navegação e fornece uma estrutura clara para os usuários.

P: O que são elementos de estrutura em nível de bloco e em nível inline e como eles diferem?

R: Os elementos da estrutura em nível de bloco representam blocos maiores de conteúdo, como parágrafos e títulos, enquanto os elementos em nível embutido representam partes do texto dentro de um parágrafo ou título, como trechos, citações e notas. Eles ajudam a definir a hierarquia e os relacionamentos de conteúdo.

P: Como a arte estrutura os elementos, como`FigureElement` and `FormulaElement`, contribute to the document?

R: Os elementos da estrutura da arte permitem adicionar ilustrações, figuras e fórmulas matemáticas ao documento. Eles fornecem uma maneira estruturada de incluir conteúdo visual e matemático.

P: Posso usar técnicas semelhantes para criar outros tipos de elementos estruturais, como listas, tabelas ou anotações?

R: Sim, você pode usar técnicas semelhantes para criar outros tipos de elementos estruturais, como listas, tabelas, anotações, referências e muito mais. Aspose.PDF fornece uma ampla gama de métodos de criação de elementos de estrutura.

P: Como salvar o documento PDF marcado usando o`Save` method ensure the preservation of structure elements?

R: OSave O método salva o documento PDF junto com os elementos da estrutura criada, garantindo que a estrutura hierárquica e semântica do documento seja preservada para acessibilidade e navegação.

P: Quais benefícios os elementos estruturais trazem aos documentos PDF em termos de acessibilidade e compatibilidade com tecnologias assistivas?

R: Os elementos estruturais melhoram a acessibilidade, fornecendo uma estrutura e uma semântica significativas ao documento. Isso permite que tecnologias assistivas, como leitores de tela, interpretem e transmitam o conteúdo do documento de forma mais eficaz para usuários com deficiência.

P: Como posso personalizar e combinar ainda mais diferentes tipos de elementos estruturais em meus documentos PDF?

R: Você pode combinar e personalizar elementos de estrutura usando métodos de criação apropriados fornecidos pelo Aspose.PDF. Experimente diferentes elementos e suas propriedades para criar um documento PDF bem estruturado e organizado.

Crie PDF com texto marcado Criar árvore de elementos estruturais