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) і зберігати точність під час перекомпонування вмісту

Поширені значення кольорів: чорний = (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