AddRoleMap

Тегированный PDF, Доступность

Описание

Эта страница документирует AddRoleMap в PDFlibPas в разделе Тегированный PDF, Доступность. Имена API, параметры, классы, имена файлов и литеральные значения сохраняются без перевода, чтобы соответствовать библиотеке Delphi и точкам входа DLL.

Перед вызовом функции проверьте синтаксис, параметры и возвращаемые значения. Блоки кода оставлены в исходном виде, чтобы примеры можно было копировать без изменений.

При использовании этой API учитывайте ограничения PDF/A, минимально требуемую версию PDF, внешние ресурсы и выбранное состояние документа.

Перед вызовом функции проверьте синтаксис, параметры и возвращаемые значения. Блоки кода оставлены в исходном виде, чтобы примеры можно было копировать без изменений. BeginTag, BeginTagEx

Синтаксис

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

Параметры

CustomType	`CustomType` является параметром `AddRoleMap`. Используйте тип из сигнатуры и значение, соответствующее текущему PDF-документу, выбранной странице или активному ресурсу. BeginTag, BeginTagEx
StandardType	`StandardType` является параметром `AddRoleMap`. Используйте тип из сигнатуры и значение, соответствующее текущему PDF-документу, выбранной странице или активному ресурсу.

Возвращаемые значения

0	Это значение описывает результат `AddRoleMap`. Обычно ненулевое значение означает успех, а 0 означает, что операция не завершена.
1	Это значение описывает результат `AddRoleMap`. Обычно ненулевое значение означает успех, а 0 означает, что операция не завершена.

Пример

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