SetStructElemColor

Tagged PDF, Accessibility

Description

在标记栈上当前打开的结构元素上设置 /Color 属性（布局属性所有者）；该值将元素内容的背景前景色（文本或描边）指定为 RGB 三元组；等效于以 Owner=Layout、Name=Color 以及空格分隔的 R G B 字符串调用 AddTagAttribute

Syntax

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

Parameters

R	颜色的红色分量，范围为 0.0（无红色）至 1.0（全红）
G	颜色的绿色分量，范围为 0.0 至 1.0
B	颜色的蓝色成分，范围在 0.0 到 1.0 之间

Return value

成功时返回 1；如果未打开任何文档或标记栈上当前未打开任何标记，则返回 0

Remarks

在 BeginTag 或 BeginTagEx 之后以及 EndTag 之前调用此函数；/Color 属性在 ISO 32000-1 §14.8.5.4.2（布局属性所有者，表 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)

Example

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