SetStructElemColor

Getagde PDF, toegankelijkheid

Beschrijving

Stelt het /Color-attribuut (eigenaar van het Layout-attribuut) in op het structuurelement dat momenteel boven aan de tagstack staat. De waarde specificeert de voorgrondkleur (tekst- of lijnkleur) van de inhoud van het element als een RGB-triplet. Equivalent aan het aanroepen van AddTagAttribute met Owner=Layout, Name=Color en een door spaties gescheiden R G B-tekenreeks

Syntaxis

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

Parameters

Retourwaarde

Retourneert 1 bij succes. Retourneert 0 als er geen document is geopend of momenteel geen tag op de tagstack geopend is

Opmerkingen

Roep deze functie aan na BeginTag of BeginTagEx en vóór EndTag. Het attribuut /Color is gedefinieerd in ISO 32000-1 §14.8.5.4.2 (Layout-attribuuteigenaar, Table 340) en wordt opgeslagen als PDF-array van drie getallen

Dit attribuut beschrijft de voorgrondkleur van het element zoals een hulptechnologie of re-flow-engine die waarneemt. Het is adviserend — de visuele kleur in de PDF wordt door de graphics state bepaald, niet door dit attribuut. Nauwkeurige kleurinformatie doorgeven maakt het downstream-tools wel mogelijk kleurcontrastverhoudingen te controleren (WCAG 2.x Succescriterium 1.4.3) en bij het omzetten van de inhoud getrouw te blijven

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

Voorbeeld

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

Zie ook

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag