SetStructElemTitleA

PDF con tag & accessibilità

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a SetStructElemTitle e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta la voce /T (titolo) sull'elemento in creazione nello stack dei tag. Il titolo è un'etichetta leggibile che caratterizza l'elemento, ad esempio Chapter 1, Summary Table o Figure 3: Quarterly Sales, anziché ripeterne solo il tipo

Sintassi

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

Parametri

Title	Stringa di testo leggibile che identifica questa specifica istanza dell'elemento. Passare una stringa vuota per cancellare un valore impostato in precedenza.

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun elemento della struttura è aperto o nessun documento è selezionato

Note

La voce /T è definita in ISO 32000-1 §14.7.2 Table 324. Viene scritta come stringa di testo PDF nel dizionario dell'elemento di struttura.

Title ha uno scopo distinto dalle altre proprietà testuali di un elemento della struttura:

/T (Title) — Etichetta descrittiva per navigazione e pannelli tag, adatta a titoli di sezione e didascalie di tabelle o figure.
/Alt (vedere SetStructElemAltText) — Sostituto testuale completo dell'elemento per le tecnologie assistive quando non può essere renderizzato
/ActualText (vedere SetStructElemActualText) — Sostituzione Unicode esatta per le sequenze di glifi il cui testo estratto risulterebbe errato

I viewer usano /T nel pannello Tags; gli strumenti di accessibilità come titolo di riferimento. Per H1–H6 il contenuto è già il titolo; /T è più utile per Table, Figure, Form, Sect o Div

Esempio

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

Vedere anche

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics