BeginTagA

Tagged PDF, Tilgængelighed

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med BeginTag, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Åbner et tagged PDF-strukturelement på den aktuelle side. Skriver operatoren BDC (Begin Marked Content with Dictionary) til indholdsstrømmen og registrerer elementet i dokumentets logiske strukturtræ. Strukturtræet færdiggøres automatisk, når dokumentet gemmes

Tags skal være afbalancerede: hvert kald til BeginTag skal efterfølges af et tilsvarende kald til EndTag. Tags kan indlejres.

Syntaks

Delphi

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

DLL

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

Parametre

TagType	PDF-standardstrukturtype: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` osv. (se ISO 32000-1 §14.8.4).
AltText	Alternativ tekst til billeder og andet ikke-tekstligt indhold (knyttes til PDF-attributten `/Alt`). Angiv en tom streng, hvis den ikke er påkrævet
ActualText	Erstatningstekst for indhold, hvis visuelle repræsentation afviger fra dets logiske betydning (svarer til PDF-attributten `/ActualText`). Angiv en tom streng, hvis den ikke er nødvendig

Returværdier

0	Mislykkedes (intet dokument er åbent)
1	Tagget blev åbnet

Eksempel

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

Bemærkninger

Brug BeginArtifact/EndArtifact til dekorativt indhold (sidehoveder, sidefødder, baggrundselementer), som skærmlæsere ikke skal læse.

Dokumentet skal være i skrivetilstand (oprettet eller åbnet til ændring). Kald SetPDFUAMode før mærkning for at opfylde kravene i PDF/UA-1