SetStructElemColor

タグ付き PDF、アクセシビリティ

説明

タグスタックで現在開いている構造要素に /Color 属性（Layout 属性所有者）を設定します。値は要素コンテンツの前景色（テキストまたはストローク）を RGB 3 要素で指定します。これは AddTagAttribute を Owner=Layout、Name=Color、空白区切りの R G B 文字列で呼び出す場合と同等です

構文

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

パラメータ

R	0.0（赤なし）から 1.0（完全な赤）までの範囲にある色の赤成分
G	色の緑成分。範囲は 0.0～1.0
B	0.0 から 1.0 の範囲にある色の青成分

戻り値

成功時は 1 を返します。文書が開かれていない場合、またはタグスタックで現在開かれているタグがない場合は 0 を返します

備考

BeginTag または BeginTagEx の後、EndTag の前にこの関数を呼び出します /Color 属性は ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Table 340) で定義され、数値 3 要素の PDF 配列として格納されます

この属性は、支援技術またはリフローエンジンが認識する要素の前景色を記述します。これは助言的な属性であり、PDF で描画される視覚的な色はこの属性ではなくグラフィックス状態で制御されます。ただし正確な色情報を提供すると、下流ツールが色コントラスト比（WCAG 2.x Success Criterion 1.4.3）を確認でき、コンテンツのリフロー時の忠実度を維持できます

一般的な色の値: 黒 = (0.0, 0.0, 0.0)、白 = (1.0, 1.0, 1.0)、赤 = (1.0, 0.0, 0.0)

例

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

SetStructElemColor

説明

構文

Delphi

ActiveX

DLL

パラメータ

戻り値

備考

例

関連項目