BeginTag

PDF con tag, accessibilità

Descrizione

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 TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * 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.

L'applicazione dei tag contrassegna il documento come tale al salvataggio, requisito necessario affinché un lettore riconosca la struttura. Un'impostazione SetMarkInfo del chiamante resta invariata