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 属性所有者，表 340），并存储为含三个数字元素的 PDF 数组

此属性描述辅助技术或重排引擎感知到的元素前景色。它仅起建议作用——PDF 中呈现的视觉颜色由图形状态控制，而非此属性。不过，提供准确的颜色信息可使下游工具检查颜色对比度（WCAG 2.x 成功准则 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;

另请参阅

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag