AddRoleMapA

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 AddRoleMap, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Registrerer en tilknytning fra et brugerdefineret navn på en strukturelementtype til en PDF-standardstrukturtype i dokumentets RoleMap-ordbog.

Når tagged PDF-indhold bruger ikke-standardiserede tagnavne (f.eks. virksomhedsspecifikke eller programspecifikke elementtyper), kræver PDF-specifikationen, at disse navne tilknyttes en standard-PDF-strukturtype i strukturtrærodens /RoleMap-post. ISO 14289-1 §7.1 kræver denne tilknytning for alle PDF/UA-1-dokumenter, der indeholder ikke-standardiserede strukturelementtyper

Kald AddRoleMap én gang for hver brugerdefineret type, før BeginTag eller BeginTagEx kaldes med denne type. Der kan registreres flere tilknytninger. Hvis den samme brugerdefinerede type registreres mere end én gang, vinder den seneste tilknytning.

RoleMap skrives til strukturtræets rod, når dokumentet gemmes, hvis mindst én tilknytning er registreret

Syntaks

Delphi

Function DLAddRoleMapA(InstanceID: Integer; CustomType, StandardType: PAnsiChar): Integer;

DLL

int DLAddRoleMapA(int InstanceID, const char * CustomType, const char * StandardType);

Parametre

CustomType	Navnet på den brugerdefinerede (ikke-standardiserede) strukturelementtype, der bruges i kald til BeginTag eller BeginTagEx, f.eks. `Headline`, `Caption`, `Callout`.
StandardType	Den standard-PDF-strukturtype, som den brugerdefinerede type knyttes til: `P`, `H1`–`H6`, `Figure`, `Table`, `Span`, `Link`, `Note` osv. (se ISO 32000-1 §14.8.4). Skal være en anerkendt standardtype, før tilknytningen opfylder PDF/UA-overensstemmelseskontroller.

Returværdier

0	Mislykkedes (intet dokument er åbent)
1	Tilknytningen blev registreret

Eksempel

// Document with custom element types mapped to standard PDF structure types
PDF.SetPDFUAMode('en-US');
PDF.AddRoleMap('Headline', 'H1');
PDF.AddRoleMap('Subheadline', 'H2');
PDF.AddRoleMap('Caption', 'P');

PDF.BeginTag('Headline', '', '');
PDF.PrintText(50, 750, 'Annual Report 2026');
PDF.EndTag;

PDF.BeginTag('Subheadline', '', '');
PDF.PrintText(50, 720, 'Financial Highlights');
PDF.EndTag;