BeginTagA
Tagged PDF, Barrierefreiheit
Beschreibung
Das angehängte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten ist mit BeginTag identisch, und Zeichenfolgenargumente werden anhand der aktuellen SetAnsiMode-Codeseite interpretiert
Ö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 DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;DLL
int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * 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.