BeginTagA

Taggad PDF, tillgänglighet

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med BeginTag och strängargument tolkas med aktuell SetAnsiMode-kod sida

Öppnar ett taggat-PDF-strukturelement på den aktuella sidan. Skriver en BDC-operator (Begin Marked Content with Dictionary) till innehållsströmmen och registrerar elementet i dokumentets logiska strukturträd. Strukturträdet färdigställs automatiskt när dokumentet sparas

Taggar måste balanseras: varje BeginTag-anrop måste följas av ett matchande EndTag-anrop. Taggar får nästlas

Syntax

Delphi

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

DLL

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

Parametrar

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	Alternativ text för bilder och annat icke-textinnehåll (mappar till PDF-attributet `/Alt`). Ange en tom sträng om den inte behövs
ActualText	Ersättningstext för innehåll vars visuella representation skiljer sig från dess logiska betydelse (mappar till PDF-attributet `/ActualText`). Ange en tom sträng om den inte behövs

Returvärden

0	Misslyckades (inget dokument är öppet)
1	Tag opened successfully

Exempel

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

Anmärkningar

Använd BeginArtifact/EndArtifact för dekorativt innehåll (sidhuvuden, sidfötter, bakgrundselement) som inte bör läsas av skärmläsare

Dokumentet måste vara i skrivläge (skapat eller öppnat för ändring). Anropa SetPDFUAMode före taggning för att uppfylla PDF/UA-1-kraven