SetStructElemColor

Označeni PDF, Dostopnost

Opis

Nastavi atribut /Color (lastnik atributa Layout) na strukturnem elementu, ki je trenutno odprt na skladu oznak. Vrednost določa barvo ospredja (besedila ali poteze) vsebine elementa kot trojček RGB. Enakovredno klicu AddTagAttribute z Owner=Layout, Name=Color in z nizom R G B, ločenim s presledki

Sintaksa

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

Parametri

R	Rdeča komponenta barve v razponu od 0,0 (brez rdeče) do 1,0 (polna rdeča)
G	Zelena komponenta barve v razponu od 0,0 do 1,0
B	Modra komponenta barve v razponu od 0,0 do 1,0

Vrnjena vrednost

Ob uspehu vrne 1. Vrne 0, če noben dokument ni odprt ali na skladu oznak trenutno ni odprta nobena oznaka

Opombe

Funkcijo pokličite po BeginTag ali BeginTagEx in pred EndTag. Atribut /Color je definiran v ISO 32000-1 §14.8.5.4.2 (lastnik atributov postavitve, tabela 340) in se shrani kot tročlenska PDF tabela števil

Atribut opisuje barvo ospredja elementa, kot jo zazna pomožna tehnologija ali mehanizem za pretakanje (re-flow). Nasveten je — vizualno barvo, izrisano v PDF, nadzoruje grafično stanje, ne ta atribut. Natančna barvna informacija pa orodjem v nadaljevanju omogoča preverjanje razmerij kontrasta barv (WCAG 2.x, merilo uspešnosti 1.4.3) in ohranjanje zvestobe pri pretakanju vsebine

Pogoste barvne vrednosti: črna = (0.0, 0.0, 0.0); bela = (1.0, 1.0, 1.0); rdeča = (1.0, 0.0, 0.0)

Primer

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

Glejte tudi

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag