AddRoleMap

태그 지정 PDF, 접근성

설명

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

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

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

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

구문

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

매개변수

반환 값

예제

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