BeginTag

Tagged PDF, Akadálymentesítés

Leírás

Megnyit egy címkézett PDF-struktúraelemet az aktuális oldalon. A tartalomfolyamba BDC (Begin Marked Content with Dictionary) operátort ír, és az elemet regisztrálja a dokumentum logikai struktúrafájában. A struktúrafa automatikusan véglegesül a dokumentum mentésekor

A címkéknek kiegyensúlyozottnak kell lenniük: minden BeginTag hívást egyező EndTag hívásnak kell követnie. A címkék egymásba ágyazhatók

Szintaxis

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

Paraméterek

TagType	Szabványos PDF-struktúratípus: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` stb. (lásd: ISO 32000-1 §14.8.4)
AltText	Alternatív szöveg képekhez és más nem szöveges tartalomhoz (a PDF `/Alt` attribútumára képeződik le). Ha nem szükséges, adjon át üres karakterláncot
ActualText	Helyettesítő szöveg olyan tartalomhoz, amelynek vizuális megjelenése eltér a logikai jelentésétől (a PDF `/ActualText` attribútumára képeződik). Ha nincs rá szükség, adjon meg üres karakterláncot

Visszatérési értékek

0	Sikertelen (nincs nyitott dokumentum)
1	A címke sikeresen megnyílt

Példa

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

Megjegyzések

A képernyőolvasók által nem olvasandó dekoratív tartalomhoz (oldalfejlécek, láblécek, háttérelemek) használja a BeginArtifact/EndArtifact függvényeket

A dokumentumnak írási módban kell lennie (létrehozva vagy módosításra megnyitva). A címkézés előtt hívja meg a SetPDFUAMode metódust a PDF/UA-1 követelményeinek teljesítéséhez

A dokumentum címkézése mentéskor címkézettként jelöli, amelyre az olvasónak szüksége van, mielőtt egyáltalán meglévőként kezeli a struktúrát. A hívó által megadott SetMarkInfo beállítás változatlan marad