BeginTag

Tagged PDF, saavutettavuus

Kuvaus

Avaa tunnisteellisen PDF:n rakenne-elementin nykyisellä sivulla. Kirjoittaa sisältövirtaan BDC-operaattorin (Sanakirjalla varustetun merkityn sisällön aloitus) ja rekisteröi elementin dokumentin loogiseen rakennepuuhun. Rakennepuu viimeistellään automaattisesti, kun dokumentti tallennetaan

Tagien on oltava tasapainossa: jokaisen BeginTag-kutsun jälkeen on tehtävä vastaava EndTag-kutsu. Tagit voivat olla sisäkkäin

Syntaksi

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

Parametrit

TagType	Vakioto PDF-rakennetyyppi: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` jne. (katso ISO 32000-1 §14.8.4)
AltText	Vaihtoehtoinen teksti kuville ja muulle ei-tekstilliselle sisällölle (vastaa PDF:n `/Alt`-attribuuttia). Anna tyhjä merkkijono, jos ei tarvita
ActualText	Korvaava teksti sisällölle, jonka visuaalinen esitys poikkeaa loogisesta merkityksestä (vastaa PDF:n `/ActualText`-attribuuttia). Anna tyhjä merkkijono, jos ei tarvita

Paluuarvot

0	Epäonnistui (mikään asiakirja ei ole avoinna)
1	Tag opened successfully

Esimerkki

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

Huomautukset

Käytä paria BeginArtifact/EndArtifact koristeelliselle sisällölle (sivujen ylä- ja alatunnisteet, taustaelementit), jota ruudunlukijoiden ei pidä lukea.

Asiakirjan on oltava kirjoitustilassa (luotu tai avattu muokkausta varten). Kutsu funktiota SetPDFUAMode ennen tagien luomista, jotta PDF/UA-1-vaatimukset täyttyvät

Tagatessa asiakirja merkitään tagatuksi tallennettaessa, mikä lukijan tarvitsee ennen kuin se ylipäätään käsittelee rakennetta olemassa olevana. Kutsujan tekemä SetMarkInfo-asetus jätetään ennalleen