SetStructElemColor

Tagged PDF, Tilgængelighed

Beskrivelse

Angiver attributten /Color (attributsejer Layout) på det strukturelement, der aktuelt er åbent på tagstakken. Værdien angiver forgrundsfarven (tekst eller streg) for elementets indhold som en RGB-triplet. Svarer til et kald af AddTagAttribute med Owner=Layout, Name=Color og en mellemrumsepareret 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);

Parametre

R	Farvens røde komponent i intervallet 0,0 (ingen rød) til 1,0 (fuld rød).
G	Farvens grønne komponent i intervallet 0,0 til 1,0
B	Farvens blå komponent i intervallet 0,0 til 1,0.

Returværdi

Returnerer 1 ved succes. Returnerer 0, hvis intet dokument er åbent, eller intet tag aktuelt er åbent på tagstakken

Bemærkninger

Kald denne funktion efter BeginTag eller BeginTagEx og før EndTag. Attributten /Color er defineret i ISO 32000-1 §14.8.5.4.2 (Layout-attributindehaver, Table 340) og gemmes som et PDF-array med tre tal.

Denne attribut beskriver elementets forgrundsfarve, som den opfattes af en hjælpeteknologi eller et reflow-program. Den er vejledende — den visuelle farve, der gengives i PDF-dokumentet, styres af grafiktilstanden, ikke af denne attribut. Korrekte farveoplysninger gør dog efterfølgende værktøjer i stand til at kontrollere farvekontrastforhold (WCAG 2.x, succeskriterium 1.4.3) og bevare troværdigheden ved reflow af indhold

Almindelige farveværdier: sort = (0,0, 0,0, 0,0); hvid = (1,0, 1,0, 1,0); rød = (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