EndTag

PDF marcado, Acessibilidade

Descrição

Fecha o elemento de estrutura aberto mais recentemente no topo da pilha de tags, gravando um operator EMC (End Marked Content) no content stream da página atual e retirando o elemento da pilha. Cada chamada a BeginTag, BeginTagEx ou BeginTagEx2 deve ser correspondida por exatamente uma chamada a EndTag antes de o documento ser salvo ou a próxima página ser adicionada.

Sintaxe

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Valores retornados

0	Falhou — não há documento aberto ou a pilha de tags está vazia (`EndTag` foi chamado mais vezes que as funções `Begin*` correspondentes)
1	O elemento de estrutura foi fechado com sucesso.

Observações

As tags devem se aninhar de forma limpa. Cada EndTag fecha o elemento de estrutura aberto mais interno; a ordem de fechamento é estritamente o inverso da ordem de abertura, da mesma forma que elementos de bloco comuns se aninham em HTML ou XML.

Se um documento for salvo com um ou mais elementos de estrutura ainda abertos, GetPDFUADiagnostics reporta a contagem sob o código STRUCT-UNCLOSED. Elementos não fechados ficam ausentes da árvore de estrutura salva, de modo que as seções de conteúdo marcado correspondentes em cada página ficam sem pai lógico — a tecnologia assistiva as ignora.

Não use EndTag para fechar uma região de artifact aberta com BeginArtifact; para isso chame EndArtifact. Artifacts e elementos de estrutura vivem em pilhas de marked content independentes.

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

Veja também

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics