AddRoleMap

PDF etiquetado, Accesibilidad

Descripción

Registra una asignación de un nombre de tipo de elemento de estructura personalizado a un tipo de estructura PDF estándar en el diccionario RoleMap del documento

Los nombres de etiqueta no estándar deben asignarse a un tipo estructural estándar mediante /RoleMap en la raíz. ISO 14289-1 §7.1 lo exige para PDF/UA-1

Llame a AddRoleMap por tipo personalizado antes de BeginTag o BeginTagEx. Si se repite, gana la última asignación

RoleMap se escribe en la raíz del árbol de estructura al guardar el documento si se registró al menos una asignación

Sintaxis

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

Parámetros

CustomType	El nombre de tipo del elemento de estructura personalizado (no estándar) utilizado en las llamadas a BeginTag o BeginTagEx, por ejemplo, `Headline`, `Caption` o `Callout`
StandardType	El tipo de estructura PDF estándar al que se asigna el tipo personalizado: `P`, `H1`–`H6`, `Figure`, `Table`, `Span`, `Link`, `Note`, etc. (consulte ISO 32000-1 §14.8.4). Debe ser un tipo estándar reconocido para que la asignación satisfaga los comprobadores de conformidad PDF/UA

Valores devueltos

0	Error (no hay ningún documento abierto)
1	La correspondencia se registró correctamente

Ejemplo

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