BeginTagA

Getagde PDF, toegankelijkheid

Beschrijving

De afsluitende A geeft het ANSI (char)-DLL-entrypoint aan; het ActiveX/COM-oppervlak biedt alleen de Unicode-vorm. Het gedrag is identiek aan BeginTag en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina

Opent een getagd-PDF-structuurelement op de huidige pagina. Schrijft een BDC-operator (Begin Marked Content with Dictionary) naar de inhoudsstroom en registreert het element in de logische structuurboom van het document. De structuurboom wordt automatisch afgerond wanneer het document wordt opgeslagen

Tags moeten in balans zijn: op elke BeginTag-aanroep moet een bijbehorende EndTag-aanroep volgen. Tags mogen genest zijn

Syntaxis

Delphi

Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);

Parameters

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	Alternatieve tekst voor afbeeldingen en andere niet-tekstinhoud (mapt op het PDF `/Alt`-attribuut). Geef een lege string door als dat niet nodig is
ActualText	Vervangende tekst voor inhoud waarvan de visuele representatie afwijkt van de logische betekenis (mapt op het PDF `/ActualText`-attribuut). Geef een lege string door als dat niet nodig is

Retourwaarden

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

Voorbeeld

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

Opmerkingen

Gebruik BeginArtifact/EndArtifact voor decoratieve inhoud (paginakoppen, voetteksten, achtergrondelementen) die niet door screenreaders moet worden gelezen

Het document moet in schrijfmodus staan (aangemaakt of geopend voor wijziging). Roep SetPDFUAMode aan vóór het taggen om aan de PDF/UA-1-vereisten te voldoen