EndTag

Tagged PDF, Barrierefreiheit

Beschreibung

Schließt das zuletzt geöffnete Strukturelement im Tag-Stack, schreibt einen EMC-Operator (End Marked Content) in den Inhaltsstream der aktuellen Seite und nimmt das Element vom Stack. Jedem Aufruf von BeginTag, BeginTagEx oder BeginTagEx2 muss vor dem Speichern des Dokuments oder dem Hinzufügen der nächsten Seite genau ein Aufruf von EndTag entsprechen

Syntax

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Rückgabewerte

0	Fehlgeschlagen — es ist kein Dokument geöffnet oder der Tag-Stapel ist leer (`EndTag` wurde häufiger als die zugehörigen `Begin*`-Funktionen aufgerufen).
1	Das Strukturelement wurde erfolgreich geschlossen

Anmerkungen

Tags müssen sauber verschachtelt sein. Jedes EndTag schließt das innerste offene Strukturelement; die Schließreihenfolge ist strikt die Umkehrung der Öffnungsreihenfolge, genauso wie gewöhnliche Blockelemente in HTML oder XML verschachtelt werden

Wenn ein Dokument mit einem oder mehreren noch geöffneten Strukturelementen gespeichert wird, meldet GetPDFUADiagnostics die Anzahl unter dem Code STRUCT-UNCLOSED. Nicht geschlossene Elemente fehlen im gespeicherten Strukturbaum, sodass die entsprechenden Abschnitte markierter Inhalte auf jeder Seite keinen logischen übergeordneten Knoten besitzen — Hilfstechnologien überspringen sie

Verwenden Sie nicht EndTag, um einen mit BeginArtifact geöffneten Artefaktbereich zu schließen; rufen Sie dafür EndArtifact auf. Artefakte und Strukturelemente befinden sich in unabhängigen Stacks für markierte Inhalte

Beispiel

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

Siehe auch

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics