AddRoleMapA

태그 지정 PDF, 접근성

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면에는 Unicode 형식만 제공됩니다. 동작은 AddRoleMap과 동일하며 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용하여 해석됩니다

사용자 지정 구조 요소 유형 이름에서 문서의 RoleMap 사전에 있는 표준 PDF 구조 유형으로의 매핑을 등록합니다

태그가 지정된 PDF 콘텐츠에서 비표준 태그 이름(예: 회사 또는 애플리케이션 전용 요소 형식)을 사용하면 PDF 사양에서는 해당 이름을 구조 트리 루트의 /RoleMap 항목에서 표준 PDF 구조 형식에 매핑하도록 요구합니다. ISO 14289-1 §7.1에서는 비표준 구조 요소 형식을 포함하는 모든 PDF/UA-1 문서에 이 매핑을 의무화합니다

사용자 지정 형식마다 AddRoleMap을 한 번 호출한 후 해당 형식으로 BeginTag 또는 BeginTagEx를 호출합니다. 여러 매핑을 등록할 수 있습니다. 같은 사용자 지정 형식을 두 번 이상 등록하면 마지막 매핑이 사용됩니다

매핑이 하나 이상 등록되었으면 문서를 저장할 때 RoleMap을 구조 트리 루트에 기록합니다

구문

Delphi

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

DLL

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

매개변수

반환 값

예제

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