SetStructElemColor

PDF etichetat, Accesibilitate

Descriere

Setează atributul /Color (proprietar de atribut Layout) pe elementul de structură deschis în prezent în stiva de taguri. Valoarea specifică culoarea de prim-plan (text sau contur) a conținutului elementului ca triplet RGB. Echivalent cu apelarea AddTagAttribute cu Owner=Layout, Name=Color și un șir R G B separat prin spații.

Sintaxă

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

Valoare returnată

Returnează 1 în caz de succes. Returnează 0 dacă niciun document nu este deschis sau dacă nu există niciun tag deschis în stiva de tag-uri

Observații

Apelați această funcție după BeginTag sau BeginTagEx și înainte de EndTag. Atributul /Color este definit în ISO 32000-1 §14.8.5.4.2 (deținător de atribute Layout, Table 340) și este stocat ca un vector PDF cu trei elemente numerice

Acest atribut descrie culoarea de prim-plan a elementului, așa cum o percepe o tehnologie asistivă sau un motor de re-flow. Este orientativ — culoarea vizuală randată în PDF este controlată de starea grafică, nu de acest atribut. Totuși, furnizarea informației corecte de culoare permite uneltelor ulterioare să verifice rapoartele de contrast de culoare (WCAG 2.x Success Criterion 1.4.3) și să mențină fidelitatea la re-flow-ul conținutului

Valori de culoare obișnuite: negru = (0.0, 0.0, 0.0); alb = (1.0, 1.0, 1.0); roșu = (1.0, 0.0, 0.0)

Exemplu

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

Consultați și

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag