EndTag

Tagged PDF, Pristupačnost

Opis

Zatvara poslednje otvoreni strukturni element na steku tagova, upisujući EMC (End Marked Content) operator u content stream trenutne stranice i skidajući element sa steka. Svaki poziv BeginTag, BeginTagEx ili BeginTagEx2 mora se upariti sa tačno jednim pozivom EndTag pre čuvanja dokumenta ili dodavanja sledeće stranice

Sintaksa

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Povratne vrednosti

0Nije uspelo - nijedan dokument nije otvoren ili je stek oznaka prazan (funkcija EndTag pozvana je više puta nego odgovarajuće funkcije Begin*).
1Strukturni element je uspešno zatvoren

Napomene

Tagovi moraju lepo da se ugnježđuju. Svaki EndTag zatvara najunutrašnji otvoreni strukturni element; redosled zatvaranja je strogo obrnut od redosleda otvaranja, isto kao što se obični block elementi ugnježđuju u HTML-u ili XML-u

Ako se dokument sačuva dok je jedan ili više strukturnih elemenata još uvek otvoren, GetPDFUADiagnostics prijavljuje broj pod kodom STRUCT-UNCLOSED. Nezatvoreni elementi nedostaju u sačuvanom stablu strukture, pa odgovarajuće sekcije označenog sadržaja na svakoj stranici nemaju logičkog roditelja — asistivna tehnologija će ih preskočiti.

Ne koristite EndTag da zatvorite region artefakta otvoren sa BeginArtifact; za to pozovite EndArtifact. Artefakti i strukturni elementi žive na nezavisnim marked-content stekovima

Primer

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

Vidi takođe

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics