BeginTag

Pažymėtas PDF, pritaikymas neįgaliesiems

Aprašymas

Atveria pažymėtojo PDF struktūros elementą esamajame puslapyje. Į turinio srautą rašo BDC (Begin Marked Content with Dictionary) operatorių ir užregistruoja elementą dokumento loginėje struktūros medyje. Struktūros medis baigiamas automatiškai išsaugojus dokumentą

Žymos turi būti subalansuotos: po kiekvieno BeginTag kvietimo turi sekti atitinkamasis EndTag kvietimas. Žymos gali būti įdėtos

Sintaksė

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

Parametrai

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	Alternatyvusis tekstas vaizdams ir kitam netekstiniam turiniui (atvaizduojamas į PDF `/Alt` atributą). Jei nereikia, perduokite tuščią eilutę
ActualText	Pakeitimasis tekstas turiniui, kurio vizualinis atvaizdavimas skiriasi nuo loginės prasmės (atvaizduojamas į PDF `/ActualText` atributą). Jei nereikia, perduokite tuščią eilutę

Grąžinamos reikšmės

0	Nepavyko (neatidarytas dokumentas)
1	Tag opened successfully

Pavyzdys

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

Pastabos

Naudokite BeginArtifact/EndArtifact dekoratyviniam turiniui (puslapių antraštėms, poraštėms, foniniams elementams), kurio ekrano skaitytuvės neturėtų skaityti

Dokumentas turi būti rašymo režimu (sukurtas arba atvertas keitimui). Prieš žymėdami iškvieskite SetPDFUAMode, kad atitiktumėte PDF/UA-1 reikalavimus

Dokumento žymėjimas, išsaugojus, pažymi jį kaip pažymėtąjį, ko skaitytuvui reikia, kad struktūrą iš viso laikytų esant. Kviesėjo atliktoji SetMarkInfo nustatymo paliekama tokia, kokia yra