EndTag

PDF con tag, accessibilità

Descrizione

Chiude l'elemento di struttura aperto più di recente nello stack dei tag, scrivendo un operatore EMC (End Marked Content) nel flusso di contenuto della pagina corrente e rimuovendo l'elemento dallo stack. A ogni chiamata a BeginTag, BeginTagEx o BeginTagEx2 deve corrispondere esattamente una chiamata a EndTag prima del salvataggio del documento o dell'aggiunta della pagina successiva

Sintassi

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Valori restituiti

0	Operazione non riuscita — nessun documento aperto o stack dei tag vuoto (`EndTag` chiamato più volte delle funzioni `Begin*` corrispondenti).
1	L'elemento della struttura è stato chiuso correttamente

Note

I tag devono annidarsi correttamente. Ogni EndTag chiude l'elemento più interno, in ordine inverso all'apertura, come in HTML o XML

Se un documento viene salvato con uno o più elementi di struttura ancora aperti, GetPDFUADiagnostics ne segnala il numero con il codice STRUCT-UNCLOSED. Gli elementi non chiusi mancano dall'albero della struttura salvato, pertanto le corrispondenti sezioni di contenuto contrassegnato di ogni pagina non hanno un genitore logico e vengono ignorate dalle tecnologie assistive

Non usare EndTag per chiudere una regione artefatto aperta con BeginArtifact; chiamare EndArtifact. Gli artefatti e gli elementi di struttura risiedono in stack di contenuto contrassegnato indipendenti

Esempio

// 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

Vedere anche

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics