BeginTagExA

Tagged PDF, Barrierefreiheit

Beschreibung

Das nachgestellte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht BeginTagEx, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Ö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 DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * 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;