SetStructElemColor

Tagged PDF, Barrierefreiheit

Beschreibung

Legt das Attribut /Color des Layout-Attributinhabers für das aktuell im Tag-Stapel geöffnete Strukturelement fest. Der Wert gibt die Vordergrundfarbe für Text oder Kontur des Elementinhalts als RGB-Tripel an. Dies entspricht einem Aufruf von AddTagAttribute mit Owner=Layout, Name=Color und einer durch Leerzeichen getrennten Zeichenfolge R G B.

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

Parameter

Rückgabewert

Gibt bei Erfolg 1 zurück. Gibt 0 zurück, wenn kein Dokument geöffnet oder aktuell kein Tag im Tag-Stapel geöffnet ist.

Anmerkungen

Rufen Sie diese Funktion nach BeginTag oder BeginTagEx und vor EndTag auf. Das Attribut /Color ist in ISO 32000-1 §14.8.5.4.2 (Attributinhaber Layout, Tabelle 340) definiert und wird als PDF-Array mit drei Zahlen gespeichert

Dieses Attribut beschreibt die Vordergrundfarbe des Elements, wie sie von Hilfstechnologien oder einer Umbruch-Engine wahrgenommen wird. Es hat Hinweischarakter — die im PDF gerenderte visuelle Farbe wird durch den Grafikzustand und nicht durch dieses Attribut gesteuert. Genaue Farbinformationen ermöglichen es nachgelagerten Werkzeugen jedoch, Farbkontrastverhältnisse zu prüfen (WCAG 2.x Erfolgskriterium 1.4.3) und beim Umbruch von Inhalten die Wiedergabetreue zu erhalten

Gängige Farbwerte: Schwarz = (0.0, 0.0, 0.0); Weiß = (1.0, 1.0, 1.0); Rot = (1.0, 0.0, 0.0)

Beispiel

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

Siehe auch

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag