BeginTag

PDF etichetat, Accesibilitate

Descriere

Deschide un element de structură PDF cu tag-uri pe pagina curentă. Scrie un operator BDC (Begin Marked Content with Dictionary) în content stream și înregistrează elementul în arborele de structură logic al documentului. Arborele de structură este finalizat automat la salvarea documentului

Tag-urile trebuie să fie echilibrate: fiecare apel BeginTag trebuie urmat de un apel EndTag potrivit. Tag-urile pot fi imbricate

Sintaxă

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	Tip de structură standard PDF: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` etc. (consultați ISO 32000-1 §14.8.4)
AltText	Text alternativ pentru imagini și alt conținut non-text (corespunde atributului PDF `/Alt`). Pasați un șir gol dacă nu este necesar
ActualText	Text de înlocuire pentru conținut a cărui reprezentare vizuală diferă de sensul său logic (corespunde atributului PDF `/ActualText`). Pasați un șir gol dacă nu este necesar

Valori returnate

0	Eșec (niciun document nu este deschis)
1	Tag opened successfully

Exemplu

// 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;

Observații

Folosiți BeginArtifact/EndArtifact pentru conținut decorativ (antete de pagină, subsoluri, elemente de fundal) care nu ar trebui citit de cititoarele de ecran

Documentul trebuie să fie în mod scriere (creat sau deschis pentru modificare). Apelați SetPDFUAMode înainte de etichetare pentru a satisface cerințele PDF/UA-1

Etichetarea unui document îl marchează ca având tag-uri la salvare, ceea ce un reader are nevoie să vadă înainte de a trata structura ca prezentă deloc. O setare SetMarkInfo făcută de apelant este lăsată așa cum este