EndTag

PDF etichetat, Accesibilitate

Descriere

Închide cel mai recent element de structură deschis pe stiva de tag-uri, scriind un operator EMC (End Marked Content) în content stream-ul paginii curente și scoțând elementul din stivă. Fiecare apel BeginTag, BeginTagEx sau BeginTagEx2 trebuie potrivit cu exact un apel EndTag înainte de salvarea documentului sau de adăugarea paginii următoare

Sintaxă

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Valori returnate

0	Eșuat — nu este deschis niciun document sau stiva de taguri este goală (`EndTag` a fost apelată de mai multe ori decât funcțiile `Begin*` corespunzătoare)
1	Elementul de structură a fost închis cu succes

Observații

Tag-urile trebuie să se imbrice curat. Fiecare EndTag închide cel mai interior element de structură deschis; ordinea de închidere este strict inversul ordinii de deschidere, în același fel în care elementele de bloc obișnuite se imbrică în HTML sau XML

Dacă un document este salvat cu unul sau mai multe elemente de structură încă deschise, GetPDFUADiagnostics raportează numărul sub codul STRUCT-UNCLOSED. Elementele neînchise lipsesc din arborele de structură salvat, astfel încât secțiunile de marked-content corespunzătoare de pe fiecare pagină nu au părinte logic — tehnologia asistivă le va sări

Nu folosiți niciodată EndTag pentru a închide o regiune de artefact deschisă cu BeginArtifact; pentru asta apelați EndArtifact. Artefactele și elementele de structură trăiesc pe stive de marked-content independente

Exemplu

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

Consultați și

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics