EndTag

Označeni PDF, Pristupačnost

Opis

Zatvara najnovije otvoreni strukturni element na stogu oznaka, zapisujući operator EMC (End Marked Content) u tok sadržaja trenutačne stranice i skidajući element sa stoga. Svaki poziv BeginTag, BeginTagEx ili BeginTagEx2 mora se upariti s točno jednim pozivom EndTag prije spremanja dokumenta ili dodavanja sljedeće stranice

Sintaksa

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Povratne vrijednosti

0	Nije uspjelo — nijedan dokument nije otvoren ili je stog oznaka prazan (`EndTag` pozvan je više puta nego odgovarajuće funkcije `Begin*`)
1	Strukturni element uspješno je zatvoren

Napomene

Oznake se moraju uredno ugnježđivati. Svaki EndTag zatvara najunutrašniji otvoreni strukturni element; redoslijed zatvaranja strogo je obrnut redoslijedu otvaranja, na isti način na koji se obični blokovski elementi ugnježđuju u HTML-u ili XML-u

Ako se dokument spremi s jednim ili više strukturnih elemenata koji su još otvoreni, GetPDFUADiagnostics izvještava broj pod kodom STRUCT-UNCLOSED. Nezatvorenih elemenata nema u spremljenom stablu strukture, pa odgovarajuće sekcije označenog sadržaja na svakoj stranici ostaju bez logičkog roditelja — asistivna tehnologija preskočit će ih.

Nemojte koristiti EndTag za zatvaranje regije artefakta otvorene s BeginArtifact; za to pozovite EndArtifact. Artefakti i strukturni elementi žive na neovisnim stogovima označenog sadržaja.

Primjer

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

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics