SetStructElemColor

Tagovaný PDF, prístupnosť

Opis

Nastaví atribút /Color (vlastník atribútov Layout) na štruktúrnom prvku aktuálne otvorenom na zásobníku tagov. Hodnota určuje farbu popredia (textu alebo ťahu) obsahu prvku ako RGB trojicu. Ekvivalent volania AddTagAttribute s Owner=Layout, Name=Color a reťazcom R G B oddeleným medzerami.

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

Parametre

R	Červená zložka farby v rozsahu 0.0 (žiadna červená) až 1.0 (plná červená).
G	Zelená zložka farby v rozsahu 0.0 až 1.0.
B	Modrá zložka farby v rozsahu 0.0 až 1.0.

Návratová hodnota

Vráti 1 pri úspechu. Vráti 0, ak nie je otvorený žiadny dokument alebo sa na zásobníku tagov práve neotvára žiadny tag

Poznámky

Túto funkciu zavolajte po BeginTag alebo BeginTagEx a pred EndTag. Atribút /Color je definovaný v ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, tabuľka 340) a ukladá sa ako trojprvkové pole čísel PDF.

Tento atribút popisuje farbu popredia prvku, ako ju vníma asistívna technológia alebo reflow engine. Je poradný — vizuálna farba vykreslená v PDF sa riadi grafickým stavom, nie týmto atribútom. Poskytnutie presnej informácie o farbe však umožní downstream nástrojom kontrolovať pomer kontrastu farieb (WCAG 2.x Success Criterion 1.4.3) a zachovať vernosť pri reflow obsahu.

Bežné farebné hodnoty: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (1.0, 0.0, 0.0)

Príklad

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

Pozri tiež

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag