SetStructElemColor

Pažymėtas PDF, pritaikymas neįgaliesiems

Aprašymas

Nustato /Color atributą (išdėstymo atributo savininką) šiuo metu žymų steke atidarytame struktūros elemente. Reikšmė nurodo elemento turinio priekinio plano (teksto arba kontūro) spalvą kaip RGB trejetą. Atitinka AddTagAttribute kvietimą su Owner=Layout, Name=Color ir tarpeliais atskirta R G B eilute.

Sintaksė

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

Parametrai

R	Spalvos raudonasis komponentas, intervale nuo 0.0 (jokios raudonos) iki 1.0 (visa raudona)
G	Spalvos žaliasis komponentas, intervale nuo 0.0 iki 1.0
B	Spalvos mėlynasis komponentas, intervale nuo 0.0 iki 1.0

Grąžinama reikšmė

Sėkmės atveju grąžina 1. Grąžina 0, jei neatvertas dokumentas arba žymų dėkle šiuo metu neatverta jokia žymė

Pastabos

Šią funkciją iškvieskite po BeginTag arba BeginTagEx ir prieš EndTag. /Color atributas apibrėžtas ISO 32000-1 §14.8.5.4.2 (maketo atributų savininkas, 340 lentelė) ir saugomas kaip trijų elementų PDF skaičių masyvas.

Šis atributas aprašo elemento priekinio plano spalvą, kaip ją suvokia pagalbinė technologija arba pertvarkymo variklis. Jis patarinėjantis – vizuali spalva, atvaizduojama PDF, priklauso nuo grafikos būsenos, o ne nuo šio atributo. Vis dėlto tiksli spalvos informacija leidžia tolesniems įrankiams tikrinti spalvų kontrasto santykius (WCAG 2.x kriterijus 1.4.3) ir išlaikyti atitikį pertvarkant turinį.

Įprastosios spalvų reikšmės: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (1.0, 0.0, 0.0)

Pavyzdys

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

Taip pat žiūrėkite

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag