BeginTag

Tagovaný PDF, prístupnosť

Opis

Otvorí na aktuálnej strane štruktúrny prvok tagovaného PDF. Do obsahového prúdu zapíše operátor BDC (Begin Marked Content with Dictionary) a zaregistruje prvok v logickom štruktúrovom strome dokumentu. Štruktúrový strom sa dokončí automaticky pri uložení dokumentu.

Tagy musia byť vyvážené: každé volanie BeginTag musí nasledovať zodpovedajúce volanie EndTag. Tagy môžu byť vnorené.

Syntax

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

Parametre

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Alternatívny text pre obrázky a iný netextový obsah (mapuje sa na atribút PDF `/Alt`). Ak nie je potrebný, odovzdajte prázdny reťazec.
ActualText	Náhradný text pre obsah, ktorého vizuálna podoba sa odlišuje od logického významu (mapuje sa na atribút PDF `/ActualText`). Ak nie je potrebný, odovzdajte prázdny reťazec.

Návratové hodnoty

0	Failed (no document is open)
1	Tag opened successfully

Príklad

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

Poznámky

Pre dekoratívny obsah (hlavičky a päty strán, prvky pozadia), ktorý nemajú čítačky obrazovky čítať, použite BeginArtifact/EndArtifact.

Dokument musí byť v režime zápisu (vytvorený alebo otvorený na úpravu). Pred tagovaním zavolajte SetPDFUAMode, aby boli splnené požiadavky PDF/UA-1.

Označenie dokumentu tagmi ho pri uložení označí ako tagovaný, čo čítačka potrebuje, aby štruktúru vôbec považovala za prítomnú. Nastavenie SetMarkInfo od volajúceho zostáva nedotknuté.