SetStructElemColor

PDF con tag, accessibilità

Descrizione

Imposta l'attributo /Color (proprietario dell'attributo Layout) sull'elemento della struttura attualmente aperto nello stack dei tag. Il valore specifica il colore di primo piano (testo o tratto) del contenuto dell'elemento come terna RGB. Equivale a chiamare AddTagAttribute con Owner=Layout, Name=Color e una stringa R G B separata da spazi

Sintassi

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

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Chiamare questa funzione dopo BeginTag o BeginTagEx e prima di EndTag. L'attributo /Color è definito in ISO 32000-1 §14.8.5.4.2 (proprietario degli attributi Layout, Table 340) ed è memorizzato come matrice PDF di tre numeri

Questo attributo descrive il colore di primo piano dell'elemento così come viene percepito da una tecnologia assistiva o da un motore di ridisposizione. È indicativo: il colore visivo generato nel PDF è controllato dallo stato grafico, non da questo attributo. Tuttavia, l'indicazione di informazioni accurate sul colore consente agli strumenti a valle di controllare i rapporti di contrasto (WCAG 2.x Success Criterion 1.4.3) e mantenere la fedeltà durante la ridisposizione del contenuto

Valori di colore comuni: nero = (0.0, 0.0, 0.0); bianco = (1.0, 1.0, 1.0); rosso = (1.0, 0.0, 0.0)

Esempio

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

Vedere anche

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag