SetStructElemExpansionA

標籤式 PDF 與無障礙

描述

結尾的 A 表示 ANSI（char）DLL 進入點，ActiveX/COM 介面僅公開 Unicode 形式。其行為與 SetStructElemExpansion 相同，字串引數會依據目前的 SetAnsiMode 字碼頁進行解譯

在標籤堆疊目前建構中的結構元素上設定 /E（展開文字）項目。展開文字是元素中縮寫或首字母縮略字的完整拼寫形式 — 例如內容為 WWW 的 Span 元素配上 World Wide Web，或內容為 ISO 的 Span 配上 International Organization for Standardization。

螢幕閱讀器與其他輔助技術會朗讀展開文字，而不是硬念縮寫字母，這對無法當單字發音的縮寫尤其重要

語法

Delphi

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

DLL

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

參數

Expansion	目前結構元素中縮寫或首字母縮略詞的完整展開文字。傳入空字串可清除先前設定。

傳回值

成功傳回 1；目前沒有開啟中的結構元素或未選取文件時傳回 0

備註

在 BeginTag 之後、目標元素位於標籤堆疊頂端時立即呼叫此函式，或在對應的 EndTag 呼叫之前的任何時點呼叫。

/E 項目定義於 ISO 32000-1 §14.9.5，以 PDF 文字字串寫入結構元素字典，與其他文字屬性不同：

/E (Expansion) — 縮寫或首字母縮略字的完整拼寫形式。供螢幕閱讀器朗讀行內縮寫內容時使用。
/Alt (see SetStructElemAltText) — A complete substitute description for elements that cannot be rendered visually (images, figures, formulas).
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would otherwise be incorrect (ligatures, glyph variants).

PDF/UA-1（ISO 14289-1 §7.2）要求每段文字的自然語言都必須能夠明確判定。縮寫與首字母縮略字若無法當成一個字朗讀，/E 就是提供這項資訊的標準機制。

把 /E 套在包住縮寫的最內層元素 — 通常是 Span 元素。展開只適用於該元素的內容，不會被子元素繼承。

範例

// 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;

另見

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics