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

Параметри

Върната стойност

Връща 1 при успех. Връща 0, ако не е отворен документ или в стека с етикети няма отворен етикет

Забележки

Извикайте тази функция след BeginTag или BeginTagEx и преди EndTag. Атрибутът /Color е дефиниран в ISO 32000-1 §14.8.5.4.2 (собственик на атрибута Layout, Table 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