EndTag

PDF etiquetado, acessibilidade

Descrição

Fecha o elemento de estrutura aberto mais recentemente na pilha de etiquetas, escrevendo um operador EMC (End Marked Content) no fluxo de conteúdo da página atual e retirando o elemento da pilha. Cada chamada a BeginTag, BeginTagEx ou BeginTagEx2 tem de corresponder exatamente a uma chamada EndTag antes de o documento ser guardado ou de a página seguinte ser adicionada

Sintaxe

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Valores devolvidos

0	Falha — não há nenhum documento aberto ou a pilha de etiquetas está vazia (`EndTag` foi chamado mais vezes do que as funções `Begin*` correspondentes)
1	O elemento de estrutura foi fechado com êxito

Observações

As etiquetas têm de estar corretamente aninhadas. Cada EndTag fecha o elemento de estrutura aberto mais interior; a ordem de fecho é rigorosamente inversa à ordem de abertura, tal como os elementos de bloco comuns se aninham em HTML ou XML

Se um documento for guardado com um ou mais elementos de estrutura ainda abertos, GetPDFUADiagnostics indica o número no código STRUCT-UNCLOSED. Os elementos não fechados ficam ausentes da árvore de estrutura guardada, pelo que as secções de conteúdo marcado correspondentes em cada página não têm um elemento principal lógico — as tecnologias de apoio irão ignorá-las

Não utilize EndTag para fechar uma região de artefacto aberta com BeginArtifact; chame EndArtifact para esse efeito. Os artefactos e os elementos de estrutura residem em pilhas independentes de conteúdo marcado

Exemplo

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

Consulte também

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics