AddRoleMap

Označeni PDF, Dostopnost

Opis

Registrira preslikavo iz imena lastnega tipa strukturnega elementa v standardni PDF-strukturi v slovarju RoleMap dokumenta

Če označena PDF-vsebina uporablja nestandardna imena oznak (npr. vrste elementov, specifične za podjetje ali aplikacijo), specifikacija PDF zahteva, da so ta imena preslikana v standardni PDF-strukturi v vnosu /RoleMap korena drevesa strukture. ISO 14289-1 §7.1 to preslikavo zahteva za vse dokumente PDF/UA-1, ki vsebujejo nestandardne vrste strukturnih elementov

Pokličite AddRoleMap enkrat za vsako lastno vrsto, pred klicem BeginTag ali BeginTagEx s to vrsto. Registrirate lahko več preslikav. Če je ista lastna vrsta registrirana več kot enkrat, velja zadnja preslikava

RoleMap se zapiše v koren drevesa strukture, ko je dokument shranjen, če je bila registrirana vsaj ena preslikava

Sintaksa

Delphi

Function TPDFlib.AddRoleMap(Const CustomType, StandardType: WideString): Integer;

ActiveX

Function PDFlib::AddRoleMap(CustomType As String, StandardType As String) As Long

DLL

int DLAddRoleMap(int InstanceID, const wchar_t * CustomType, const wchar_t * StandardType);

Parametri

CustomType	Lastno (nestandardno) ime tipa strukturnega elementa, uporabljeno v klicih BeginTag ali BeginTagEx, na primer `Headline`, `Caption`, `Callout`
StandardType	Standardni PDF-tip strukture, na katerega se preslika lastni tip: `P`, `H1`–`H6`, `Figure`, `Table`, `Span`, `Link`, `Note` itd. (glejte ISO 32000-1 §14.8.4). Za skladnost s PDF/UA morajo preverjevalniki preslikavo prepoznati kot standardni tip

Vrnjene vrednosti

0	Ni uspelo (odprt ni noben dokument)
1	Preslikava je bila uspešno registrirana

Primer

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