BeginTag

Tagged PDF, Přístupnost

Popis

Otevře prvek struktury tagged PDF na aktuální stránce. Zapíše operátor BDC (začátek označeného obsahu se slovníkem) do obsahového streamu a zaregistruje prvek ve stromu logické struktury dokumentu. Strom struktury se automaticky dokončí při uložení dokumentu

Tagy musí být vyvážené: každé volání BeginTag musí následovat odpovídající volání EndTag. Tagy lze zanořovat

Syntaxe

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

Parametry

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	Alternativní text pro obrázky a další netextový obsah (mapuje se na PDF atribut /Alt). Není-li potřeba, předejte prázdný řetězec
ActualText	Náhradní text pro obsah, jehož vizuální podoba se liší od logického významu (mapuje se na PDF atribut /ActualText). Není-li potřeba, předejte prázdný řetězec

Návratové hodnoty

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

Pří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

Use BeginArtifact/EndArtifact for decorative content (page headers, footers, background elements) that should not be read by screen readers.

Dokument musí být v režimu zápisu (vytvořený nebo otevřený pro úpravy). Pro splnění požadavků PDF/UA-1 zavolejte SetPDFUAMode před tagováním

Otagování dokumentu ho při uložení označí jako tagované, což čtečka potřebuje, dřív než začne strukturu vůbec brát v potaz. Nastavení přes SetMarkInfo od volajícího se nechá, jaké je