BeginTag

Označeni PDF, Pristupačnost

Opis

Na trenutačnoj stranici otvara strukturni element označenog PDF-a. U tok sadržaja zapisuje operator BDC (Begin Marked Content with Dictionary) i registrira element u logičkom strukturnom stablu dokumenta. Strukturno se stablo dovršava automatski pri spremanju dokumenta

Oznake moraju biti uravnotežene: svakom pozivu BeginTag mora slijediti odgovarajući poziv EndTag. Oznake se mogu ugnježđivati

Sintaksa

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	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	Alternativni tekst za slike i drugi netekstualni sadržaj (preslikava se na PDF atribut `/Alt`). Ako nije potreban, proslijedite prazan niz znakova
ActualText	Zamjenski tekst za sadržaj čiji se vizualni prikaz razlikuje od logičkog značenja (preslikava se na PDF atribut `/ActualText`). Ako nije potreban, proslijedite prazan niz znakova

Povratne vrijednosti

0	Neuspjeh (nije otvoren nijedan dokument)
1	Tag opened successfully

Primjer

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

Napomene

Upotrijebite BeginArtifact/EndArtifact za dekorativni sadržaj (zaglavlja stranica, podnožja, pozadinski elementi) koji čitači zaslona ne trebaju čitati

Dokument mora biti u načinu pisanja (stvoren ili otvoren za izmjenu). Prije označavanja pozovite SetPDFUAMode da ispunite zahtjeve PDF/UA-1

Označavanje dokumenta označava ga kao označeni pri spremanju, što čitač treba prije nego što strukturu uopće tretira kao prisutnu. Postavku SetMarkInfo koju je napravio pozivatelj ostavlja se kakva jest