SetStructElemColor

Tagged PDF, Akadálymentesítés

Leírás

A címkeveremben jelenleg megnyitott struktúraelem /Color attribútumát (Layout attribútumtulajdonos) állítja be. Az érték az elem tartalmának előtérszínét (szöveg vagy vonás) RGB-hármasként adja meg. Egyenértékű az AddTagAttribute hívásával, ahol Owner=Layout, Name=Color, valamint a szóközökkel elválasztott R G B karakterlánc

Szintaxis

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

Paraméterek

R	A szín vörös komponense a 0.0 (nincs vörös) és 1.0 (teljes vörös) tartományban
G	A szín zöld összetevője 0.0 és 1.0 közötti tartományban
B	A szín kék összetevője a 0.0 és 1.0 közötti tartományban

Visszatérési érték

Siker esetén 1-et ad vissza. 0-t ad vissza, ha nincs megnyitott dokumentum, vagy nincs aktuálisan nyitott címke a címkeveremben

Megjegyzések

Ezt a függvényt az BeginTag vagy BeginTagEx után és az EndTag előtt hívja meg. A /Color attribútum az ISO 32000-1 §14.8.5.4.2 szabványban (Layout attribútumtulajdonos, 340. táblázat) van meghatározva, és háromelemes PDF-számtömbként tárolódik

Ez az attribútum az elem előtérszínét írja le úgy, ahogyan azt egy kisegítő technológia vagy egy újratördelő motor érzékeli. Tájékoztató jellegű — a PDF-ben megjelenített vizuális színt nem ez az attribútum, hanem a grafikai állapot vezérli. A pontos színinformációk megadásával azonban a későbbi eszközök ellenőrizhetik a színkontrasztarányokat (WCAG 2.x Success Criterion 1.4.3), és az újratördelés során megőrizhetik a tartalom hűségét

Gyakori színértékek: fekete = (0.0, 0.0, 0.0); fehér = (1.0, 1.0, 1.0); vörös = (1.0, 0.0, 0.0)

Példa

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

Lásd még

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag