SetStructElemColor

Tagged PDF, Accessibility

Description

Legen Sie die Strich- und Füllfarben sowie die Linienattribute (SetLineWidth, SetLineCap, SetLineDash) vor dem Aufruf von DrawPath fest; der aktuelle Grafikzustand wird an der Aufrufstelle abgetastet

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

Parameters

R	Rote Komponente der Farbe, im Bereich 0.0 (kein Rot) bis 1.0 (volles Rot)
G	Grüne Farbkomponente im Bereich von 0.0 bis 1.0
B	Blauanteil der Farbe im Bereich von 0.0 bis 1.0

Return value

Gibt 1 bei Erfolg zurück; gibt 0 zurück, wenn kein Dokument geöffnet ist oder derzeit kein Tag auf dem Tag-Stapel geöffnet ist

Remarks

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 (Layout attribute owner, Tabelle 340) definiert und wird als dreielementiges PDF-Zahlenarray gespeichert

Dieses Attribut beschreibt die Vordergrundfarbe des Elements, wie sie von einer assistiven Technologie oder einer Re-Flow-Engine wahrgenommen wird. Es ist beratend — die im PDF gerenderte visuelle Farbe wird durch den Grafikstatus gesteuert, nicht durch dieses Attribut. Die Bereitstellung genauer Farbinformationen ermöglicht es jedoch nachgeschalteten Tools, Farbkontrastverhältnisse zu überprüfen (WCAG 2.x Erfolgskriterium 1.4.3) und die Treue beim Umbrechen von Inhalten zu wahren

Häufige Farbwerte: Schwarz = (0.0, 0.0, 0.0); Weiß = (1.0, 1.0, 1.0); Rot = (1.0, 0.0, 0.0)

Example

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