SetStructElemColor

Tagged PDF, Přístupnost

Popis

Nastaví atribut /Color (vlastník atributu Layout) na prvku struktury, který je právě otevřený na zásobníku značek. Hodnota určuje barvu popředí (textu nebo tahu) obsahu prvku jako trojici RGB. Ekvivalentem je volání AddTagAttribute s parametry Owner=Layout, Name=Color a řetězcem R G B odděleným mezerami

Syntaxe

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

Parametry

R	Červená složka barvy v rozmezí 0.0 (bez červené) až 1.0 (plná červená)
G	Zelená složka barvy v rozsahu 0.0 až 1.0
B	Modrá složka barvy v rozmezí 0.0 až 1.0

Návratová hodnota

Při úspěchu vrací 1. Vrací 0, pokud není otevřený žádný dokument nebo žádný tag v zásobníku tagů

Poznámky

Tuto funkci zavolejte po BeginTag nebo BeginTagEx a před EndTag. Atribut /Color je definovaný v ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, tabulka 340) a ukládá se jako tříprvkové pole čísel PDF.

Tento atribut popisuje barvu popředí prvku, jak ji vnímá asistivní technologie nebo reflow engine. Je poradný — vizuální barva vykreslená v PDF se řídí grafickým stavem, ne tímto atributem. Poskytnutí přesné informace o barvě ale umožní downstream nástrojům kontrolovat poměr kontrastu barev (WCAG 2.x Success Criterion 1.4.3) a zachovat věrnost při reflow obsahu.

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

Příklad

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

Viz také

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag