BeginTag

Tagged PDF, Tilgængelighed

Beskrivelse

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

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

Tagging af et dokument markerer det som tagged, når det gemmes, hvilket en læser kræver, før den overhovedet opfatter strukturen som til stede. En indstilling af SetMarkInfo, som kalderen har foretaget, bevares uændret.