BeginTag

Getagde PDF, toegankelijkheid

Beschrijving

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

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

Het taggen van een document markeert het als getagd bij het opslaan, wat een reader nodig heeft voordat hij de structuur überhaupt als aanwezig behandelt. Een door de aanroeper gezette SetMarkInfo-instelling blijft staan