SetStructElemColor

Tagget PDF, tilgjengelighet

Beskrivelse

Setter attributtet /Color (Layout som attributteier) på strukturelementet som for øyeblikket er åpent i taggstakken. Verdien angir forgrunnsfargen (tekst eller strek) i elementets innhold som en RGB-trippel. Tilsvarer å kalle AddTagAttribute med Owner=Layout, Name=Color og en mellomromsseparert R G B-streng.

Syntaks

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

Parametere

R	Rød komponent i fargen, i området 0,0 (ingen rød) til 1,0 (full rød)
G	Grønn komponent i fargen, i området 0,0 til 1,0
B	Blå komponent i fargen, i området 0,0 til 1,0

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis ingen dokument er åpent eller ingen tag står øverst på tag-stakken

Merknader

Kall denne funksjonen etter BeginTag eller BeginTagEx og før EndTag. Attributten /Color er definert i ISO 32000-1 §14.8.5.4.2 (Layout-attributteier, tabell 340) og lagres som en tre-elements PDF-matrise av tall

Denne attributten beskriver elementets forgrunnsfarge slik en assistiv teknologi eller reflow-motor oppfatter den. Den er veiledende — den visuelle fargen som rendres i PDF-en styres av grafikktilstanden, ikke av denne attributten. Nøyaktig fargeinformasjon gjør det likevel mulig for nedstrømsverktøy å sjekke kontrastforhold (WCAG 2.x suksesskriterium 1.4.3) og å holde troverdighet ved reflowing av innhold

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

Eksempel

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

Se også

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag