SetStructElemExpansionA

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 SetStructElemExpansion, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Legt den Eintrag /E (Erweiterungstext) auf dem Strukturelement fest, das derzeit auf dem Tag-Stapel aufgebaut wird. Der Erweiterungstext ist die vollständig ausgeschriebene Form einer im Element enthaltenen Abkürzung oder eines Akronyms — beispielsweise World Wide Web für ein Span-Element mit dem Inhalt WWW oder International Organization for Standardization für ein Span mit ISO.

Screenreader und andere Hilfstechnologien geben den Erweiterungstext aus, statt die abgekürzten Zeichen auszusprechen; dies ist für Abkürzungen unerlässlich, die nicht als Wörter ausgesprochen werden können

Syntax

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parameter

Expansion	Der vollständig ausgeschriebene Text der Abkürzung oder des Akronyms im aktuellen Strukturelement. Übergeben Sie eine leere Zeichenfolge, um einen zuvor festgelegten Wert zu löschen

Rückgabewert

Gibt bei Erfolg 1 oder 0 zurück, wenn derzeit kein Strukturelement geöffnet oder kein Dokument ausgewählt ist

Anmerkungen

Rufen Sie diese Funktion unmittelbar nach BeginTag auf, während sich das Zielelement oben im Tag-Stapel befindet, oder jederzeit vor dem passenden Aufruf von EndTag

Der Eintrag /E ist in ISO 32000-1 §14.9.5 definiert. Er wird als PDF-Textzeichenfolge in das Strukturelementwörterbuch geschrieben und unterscheidet sich von den anderen Texteigenschaften:

/E (Expansion) — Die ausgeschriebene Form einer Abkürzung oder eines Akronyms. Sie wird von Screenreadern zur Aussprache abgekürzter Inline-Inhalte verwendet.
/Alt (siehe SetStructElemAltText) — Eine vollständige Ersatzbeschreibung für Elemente, die nicht visuell gerendert werden können, beispielsweise Bilder, Abbildungen oder Formeln
/ActualText (siehe SetStructElemActualText) — Ein exakter Unicode-Ersatz für Glyphenfolgen, deren extrahierter Text andernfalls falsch wäre (Ligaturen, Glyphenvarianten)

PDF/UA-1 (ISO 14289-1 §7.2) verlangt, dass die natürliche Sprache jedes Textteils eindeutig bestimmbar ist. Bei Abkürzungen und Akronymen, deren Kurzform nicht als Wort vorgelesen werden kann, ist /E der Standardmechanismus zum Bereitstellen dieser Information.

Wenden Sie /E auf das innerste Element an, das die Abkürzung umschließt — normalerweise ein Span-Element. Die Erweiterung gilt nur für den Inhalt dieses Elements und wird nicht an untergeordnete Elemente vererbt.

Beispiel

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Siehe auch

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics