SetStructElemColor

標籤式 PDF、無障礙

描述

在標籤堆疊中目前開啟的結構元素上設定 /Color 屬性（Layout 屬性擁有者）。此值以 RGB 三元組指定元素內容的前景（文字或筆畫）色彩。等同於呼叫 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，表 340），以三個數字組成的 PDF 陣列儲存。

此屬性描述輔助技術或重排引擎所感知的元素前景色。它屬於建議性質 — PDF 呈現的視覺色彩由圖形狀態控制，不由這個屬性控制。不過提供準確的色彩資訊，可讓下游工具檢查色彩對比比（WCAG 2.x Success Criterion 1.4.3），並在內容重排時維持保真度。

常用顏色值：black = (0.0, 0.0, 0.0)；white = (1.0, 1.0, 1.0)；red = (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;

另見

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag