BeginTag

Tagged PDF, Barrierefreiheit

Beschreibung

Öffnet ein Tagged-PDF-Strukturelement auf der aktuellen Seite. Schreibt einen BDC-Operator (Begin Marked Content with Dictionary) in den Inhaltsstrom und registriert das Element im logischen Strukturbaum des Dokuments. Der Strukturbaum wird beim Speichern des Dokuments automatisch abgeschlossen.

Tags müssen ausgeglichen sein: Auf jeden Aufruf von BeginTag muss ein entsprechender Aufruf von EndTag folgen. Tags können verschachtelt werden

Syntax

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

Parameter

TagType	PDF-Standardstrukturtyp: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` usw. (siehe ISO 32000-1 §14.8.4).
AltText	Alternativtext für Bilder und andere Nicht-Text-Inhalte (wird dem PDF-Attribut `/Alt` zugeordnet). Übergeben Sie eine leere Zeichenfolge, wenn er nicht benötigt wird
ActualText	Ersatztext für Inhalt, dessen visuelle Darstellung von seiner logischen Bedeutung abweicht (wird dem PDF-Attribut `/ActualText` zugeordnet). Übergeben Sie eine leere Zeichenfolge, wenn er nicht erforderlich ist.

Rückgabewerte

0	Fehlgeschlagen (kein Dokument ist geöffnet)
1	Tag erfolgreich geöffnet

Beispiel

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Anmerkungen

Verwenden Sie BeginArtifact/EndArtifact für dekorative Inhalte wie Seitenkopf- und -fußzeilen oder Hintergrundelemente, die nicht von Screenreadern gelesen werden sollen

Das Dokument muss sich im Schreibmodus befinden (erstellt oder zur Änderung geöffnet). Rufen Sie SetPDFUAMode vor der Tag-Kennzeichnung auf, um die PDF/UA-1-Anforderungen zu erfüllen.

Die Tag-Kennzeichnung eines Dokuments markiert es beim Speichern als Tagged PDF, was ein Reader benötigt, bevor er die Struktur überhaupt als vorhanden behandelt. Eine vom Aufrufer vorgenommene Einstellung SetMarkInfo bleibt bestehen.