SetStructElemExpansionA

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 SetStructElemExpansion e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta la voce /E (testo espanso) sull'elemento della struttura attualmente in creazione nello stack dei tag. Il testo espanso è la forma scritta per esteso di un'abbreviazione o di un acronimo contenuto nell'elemento, ad esempio World Wide Web per un elemento Span il cui contenuto è WWW, oppure International Organization for Standardization per un Span contenente ISO

Gli screen reader pronunciano il testo espanso anziché tentare di leggere i caratteri abbreviati, essenziale per abbreviazioni non pronunciabili come parole

Sintassi

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parametri

Expansion	Testo completamente espanso dell'abbreviazione o acronimo nell'elemento di struttura corrente. Passare una stringa vuota per cancellare il valore precedente.

Valore restituito

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

Note

Chiamare subito dopo BeginTag mentre l'elemento è in cima allo stack, o prima del corrispondente EndTag

La voce /E è definita in ISO 32000-1 §14.9.5. Viene scritta come stringa di testo PDF nel dizionario struttura ed è distinta dalle altre proprietà testuali:

/E (Expansion) — Forma estesa di un'abbreviazione o acronimo, usata dagli screen reader per pronunciare il contenuto inline abbreviato.
/Alt (vedere SetStructElemAltText) — Descrizione sostitutiva completa per elementi non renderizzabili visivamente
/ActualText (vedere SetStructElemActualText) — Sostituzione Unicode esatta per le sequenze di glifi il cui testo estratto risulterebbe altrimenti errato, come legature e varianti dei glifi

PDF/UA-1 (ISO 14289-1 §7.2) richiede che la lingua naturale di ogni parte di testo sia determinabile senza ambiguità. Per abbreviazioni e acronimi la cui forma abbreviata non può essere letta ad alta voce come una parola, /E è il meccanismo standard per fornire tali informazioni

Applicare /E all'elemento più interno che racchiude l'abbreviazione, in genere un elemento Span. L'espansione si applica soltanto al contenuto di tale elemento e non viene ereditata dai figli

Esempio

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Vedere anche

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics