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) и сохранять точность при перекомпоновке содержимого.

Common color values: 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