SetStructElemColor

Tagged PDF, Accessibility

Description

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

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	Componente rossa del colore, nell'intervallo da 0.0 (nessun rosso) a 1.0 (rosso pieno)
G	Componente verde del colore, nell'intervallo da 0.0 a 1.0
B	Componente blu del colore, nell'intervallo da 0.0 a 1.0

Return value

Restituisce 1 in caso di successo; restituisce 0 se nessun documento è aperto o se nessun tag è attualmente aperto sullo stack dei tag

Remarks

Chiamare questa funzione dopo BeginTag o BeginTagEx e prima di EndTag; l'attributo /Color è definito in ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Table 340) ed è memorizzato come un array PDF di numeri a tre elementi

Questo attributo descrive il colore di primo piano dell'elemento come percepito da una tecnologia assistiva o da un motore di re-flow; ha valore consultivo — il colore visivo renderizzato nel PDF è controllato dallo stato grafico, non da questo attributo; tuttavia, fornire informazioni accurate sui colori consente agli strumenti a valle di verificare i rapporti di contrasto dei colori (WCAG 2.x Success Criterion 1.4.3) e di 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)

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;