AddRoleMapA

PDF etiquetado, Accesibilidad

Descripción

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

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

Cuando el contenido PDF etiquetado usa nombres de etiqueta no estándar (por ejemplo, tipos de elemento específicos de una empresa o aplicación), la especificación PDF exige asignarlos a un tipo de estructura PDF estándar en la entrada /RoleMap de la raíz del árbol de estructura ISO 14289-1 §7.1 obliga esta asignación para todos los documentos PDF/UA-1 que contienen tipos de elementos de estructura no estándar

Llame a AddRoleMap una vez por tipo personalizado, antes de llamar a BeginTag o BeginTagEx con ese tipo. Pueden registrarse varias asignaciones. Si el mismo tipo personalizado se registra más de una vez, prevalece la última asignación

El RoleMap se escribe en la raíz del árbol de estructura al guardar el documento, si se ha registrado 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

Valores devueltos

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;