AddRoleMapA

PDF etiquetado, Accesibilidad

Descripción

La A final indica el punto de entrada de DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico a AddRoleMap y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual

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 DLAddRoleMapA(InstanceID: Integer; CustomType, StandardType: PAnsiChar): Integer;

DLL

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

Parámetros

CustomTypeEl 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
StandardTypeEl 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

0Error (no hay ningún documento abierto)
1La 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;