BeginTagExA

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

Apre un elemento della struttura PDF con tag nella pagina corrente, con un attributo esplicito della lingua naturale. È identico a BeginTag, ma aggiunge un parametro Lang scritto nell'attributo /Lang dell'elemento della struttura

Usare per contenuti con lingua diversa da quella predefinita del documento's, impostata da SetPDFUAMode o SetDocumentLanguage. ISO 14289-1 §7.2 richiede /Lang sui segmenti in lingua diversa

I tag devono essere bilanciati: ogni chiamata BeginTagEx deve essere seguita da una chiamata corrispondente a EndTag. I tag possono essere annidati.

Sintassi

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

Parametri

TagType	Tipo di struttura PDF standard: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` e così via (vedere ISO 32000-1 §14.8.4)
AltText	Testo alternativo per immagini e altro contenuto non testuale (attributo `/Alt`). Passare una stringa vuota se non è richiesto.
ActualText	Testo sostitutivo per contenuto la cui forma visiva differisce dal significato logico, attributo `/ActualText`. Passare una stringa vuota se non serve.
Lang	Tag di lingua BCP 47 per il contenuto di questo elemento, ad esempio `en-US`, `fr-FR`, `zh-Hans`. Passare una stringa vuota per ereditare la lingua del documento. Se non è vuoto, sostituisce la lingua a livello di documento per questo elemento e tutti i suoi discendenti

Valori restituiti

0	Operazione non riuscita (nessun documento aperto)
1	Tag aperto correttamente

Esempio

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;