SetStructElemColor

Taggad PDF, tillgänglighet

Beskrivning

Sätter /Color-attributet (Layout-attributägare) på det strukturelement som för tillfället är öppet på taggstacken. Värdet anger förgrundsfärgen (text eller stroke) för elementets innehåll som en RGB-trippel. Ekvivalent med att anropa AddTagAttribute med Owner=Layout, Name=Color och en mellanslagsseparerad R G B-sträng

Syntax

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

Parametrar

R	Färgens röda komponent, i intervallet 0.0 (ingen röd) till 1.0 (full röd)
G	Färgens gröna komponent, i intervallet 0.0 till 1.0
B	Färgens blå komponent, i intervallet 0.0 till 1.0

Returvärde

Returnerar 1 vid lyckat anrop. Returnerar 0 om inget dokument är öppet eller om ingen tagg för tillfället ligger överst på taggstacken

Anmärkningar

Anropa den här funktionen efter BeginTag eller BeginTagEx och före EndTag. Attributet /Color är definierat i ISO 32000-1 §14.8.5.4.2 (Layout-attributägare, tabell 340) och lagras som en treelement PDF-array av tal

Detta attribut beskriver elementets förgrundsfärg som en hjälpmedelsteknik eller re-flow-motor uppfattar den. Det är vägledande — den visuella färg som renderas i PDF:en styrs av grafiktillståndet, inte av detta attribut. Att ändå ange korrekt färginformation låter nedströmsverktyg kontrollera färgkontrastkvoter (WCAG 2.x framgångskriterium 1.4.3) och bibehålla åtrohet när innehåll flödas om

Vanliga färgvärden: svart = (0.0, 0.0, 0.0); vit = (1.0, 1.0, 1.0); röd = (1.0, 0.0, 0.0)

Exempel

// 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 även

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag