AddRoleMapA

Tagged PDF, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddRoleMap, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Rejestruje mapowanie niestandardowej nazwy typu elementu struktury na standardowy typ struktury PDF w słowniku RoleMap dokumentu.

Gdy znakowana zawartość PDF używa niestandardowych nazw znaczników (np. typów elementów właściwych dla firmy lub aplikacji), specyfikacja PDF wymaga zmapowania tych nazw na standardowy typ struktury PDF w pozycji /RoleMap korzenia drzewa struktury. ISO 14289-1 §7.1 nakazuje takie mapowanie we wszystkich dokumentach PDF/UA-1 zawierających niestandardowe typy elementów struktury.

Wywołaj AddRoleMap raz dla każdego typu niestandardowego, zanim wywołasz BeginTag lub BeginTagEx z tym typem. Można zarejestrować wiele mapowań. Jeśli ten sam typ niestandardowy zostanie zarejestrowany wielokrotnie, obowiązuje ostatnie mapowanie.

RoleMap jest zapisywany w korzeniu drzewa struktury podczas zapisywania dokumentu, jeśli zarejestrowano co najmniej jedno mapowanie.

Składnia

Delphi

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

DLL

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

Parametry

CustomType	Niestandardowa (niestandardowa dla PDF) nazwa typu elementu struktury używana w wywołaniach BeginTag lub BeginTagEx, np. `Headline`, `Caption`, `Callout`.
StandardType	Standardowy typ struktury PDF, na który mapowany jest typ niestandardowy: `P`, `H1`–`H6`, `Figure`, `Table`, `Span`, `Link`, `Note` itd. (zob. ISO 32000-1 §14.8.4). Musi to być rozpoznawany typ standardowy, aby mapowanie spełniało wymagania kontrolerów zgodności PDF/UA.

Wartości zwracane

0	Niepowodzenie (nie otwarto dokumentu)
1	Mapowanie zostało pomyślnie zarejestrowane

Przykład

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