BeginTagA
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 BeginTag e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode
Apre un elemento della struttura PDF con tag nella pagina corrente. Scrive un operatore BDC (Begin Marked Content with Dictionary) nel flusso di contenuto e registra l'elemento nell'albero della struttura logica del documento. L'albero della struttura viene finalizzato automaticamente al salvataggio del documento
I tag devono essere bilanciati: ogni chiamata BeginTag deve essere seguita da una chiamata corrispondente a EndTag. I tag possono essere annidati.
Sintassi
Delphi
Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;DLL
int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);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 (corrisponde all'attributo PDF /Alt). Passare una stringa vuota se non richiesto. |
| ActualText | Testo sostitutivo per contenuto la cui rappresentazione visiva differisce dal significato logico, attributo PDF /ActualText. Passare stringa vuota se non serve. |
Valori restituiti
| 0 | Operazione non riuscita (nessun documento aperto) |
|---|---|
| 1 | Tag aperto correttamente |
Esempio
// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;
// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;Note
Usare BeginArtifact/EndArtifact per contenuti decorativi che gli screen reader non devono leggere
Il documento deve essere scrivibile. Chiamare SetPDFUAMode prima dei tag per soddisfare PDF/UA-1.