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（SetStructElemAltText を参照）— 視覚的にレンダリングできない要素（画像、図、数式）を完全に置き換える説明です
- /ActualText（SetStructElemActualText を参照）— 置換しなければ抽出テキストが正しくならないグリフシーケンス（合字、グリフバリアント）に対する正確な Unicode 置換です
PDF/UA-1（ISO 14289-1 §7.2）は、すべてのテキスト片の自然言語を曖昧さなく判定できることを要求します。単語として読み上げられない略語や頭字語では、/E がこの情報を提供する標準機構です
略語をラップする最も内側の要素（通常は Span 要素）に /E を適用します。展開はその要素の内容にのみ適用され、子には継承されません
例
// 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