AddRoleMapA

Getagde PDF, toegankelijkheid

Beschrijving

De afsluitende A geeft het ANSI (char)-DLL-entrypoint aan; het ActiveX/COM-oppervlak biedt alleen de Unicode-vorm. Het gedrag is identiek aan AddRoleMap en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina

Registreert een mapping van een custom structuurelement-typenaam naar een standaard PDF-structuurtype in de RoleMap-woordenboek van het document

Wanneer getagde PDF-inhoud niet-standaard tagnamen gebruikt (bijv. bedrijfsspecifieke of toepassingsspecifieke elementtypen), vereist de PDF-specificatie dat die namen in de root van de structuurboom worden toegewezen aan een standaard PDF-structuurtype in het /RoleMap-item. ISO 14289-1 §7.1 schrijft deze mapping voor voor alle PDF/UA-1-documenten met niet-standaard structuurelementtypen

Roep AddRoleMap één keer per custom type aan, vóórdat u BeginTag of BeginTagEx met dat type aanroept. Er kunnen meerdere mappings worden geregistreerd. Is hetzelfde custom type meer dan eens geregistreerd, dan wint de laatste mapping

De RoleMap wordt bij het opslaan van het document naar de structuurboomwortel geschreven, mits er ten minste één mapping is geregistreerd

Syntaxis

Delphi

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

DLL

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

Parameters

Retourwaarden

Voorbeeld

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