SetStructElemColor

Označeni PDF, Pristupačnost

Opis

Postavlja atribut /Color (vlasnik atributa Layout) na strukturnom elementu koji je trenutačno otvoren na stogu oznaka. Vrijednost određuje boju prednjeg plana (teksta ili poteza) sadržaja elementa kao RGB trojku. Ekvivalentno je pozivu AddTagAttribute s Owner=Layout, Name=Color i nizom R G B razdvojenim razmacima

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

Povratna vrijednost

Vraća 1 pri uspjehu. Vraća 0 ako nije otvoren dokument ili na stogu oznaka trenutačno nije otvorena nijedna oznaka

Napomene

Ovu funkciju pozovite nakon BeginTag ili BeginTagEx i prije EndTag. Atribut /Color definiran je u ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, tablica 340) i sprema se kao PDF polje od tri broja.

Ovaj atribut opisuje boju prednjeg plana elementa onakvom kako je doživljava asistivna tehnologija ili motor preoblikovanja. Savjetodavan je — vizualnu boju iscrtanu u PDF-u kontrolira grafičko stanje, a ne ovaj atribut. Ipak, davanje točne informacije o boji omogućuje nizvodnim alatima provjeru omjera kontrasta boja (WCAG 2.x Success Criterion 1.4.3) i očuvanje vjernosti pri preoblikovanju sadržaja.

Common color values: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (1.0, 0.0, 0.0).

Primjer

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

Vidi također

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag