BeginTagEx

Tagged PDF, Barrierefreiheit

Beschreibung

Öffnet ein Tagged-PDF-Strukturelement mit einem ausdrücklichen natürlichen Sprachattribut auf der aktuellen Seite. Entspricht BeginTag, ergänzt jedoch einen Parameter Lang, der in das Attribut /Lang des Strukturelements geschrieben wird.

Verwenden Sie diese Funktion für Inhalte, deren Sprache von der Standardsprache des Dokuments abweicht, die durch SetPDFUAMode oder SetDocumentLanguage festgelegt wird. ISO 14289-1 §7.2 verlangt, dass das Attribut /Lang für jeden Textabschnitt festgelegt wird, der nicht in der Hauptsprache des Dokuments vorliegt

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

Syntax

Delphi

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

ActiveX

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

DLL

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

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 (Attribut `/Alt`). Übergeben Sie eine leere Zeichenfolge, wenn er nicht benötigt wird
ActualText	Ersatztext für Inhalte, deren visuelle Form von ihrer logischen Bedeutung abweicht, als Attribut `/ActualText`. Eine leere Zeichenfolge übergeben, wenn er nicht benötigt wird
Lang	BCP-47-Sprachtag für den Inhalt dieses Elements, beispielsweise `en-US`, `fr-FR` oder `zh-Hans`. Übergeben Sie eine leere Zeichenfolge, um die Dokumentsprache zu erben. Ist der Wert nicht leer, setzt er die Sprache auf Dokumentebene für dieses Element und alle seine Nachfolger außer Kraft

Rückgabewerte

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

Beispiel

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;