BeginArtifactA

Структурированный PDF, Доступность

Описание

Завершающая A обозначает точку входа ANSI (char) в DLL; интерфейс ActiveX/COM открывает только Unicode-форму. Поведение идентично BeginArtifact, а строковые аргументы интерпретируются в кодовой странице, заданной текущим режимом SetAnsiMode

Открывает артефактную область PDF. Содержимое артефакта — декоративное или оформительское (колонтитулы, номера страниц, фоновые изображения, линейки) и явно исключается из логического порядка чтения документа; экранные дикторы пропускают артефактные области целиком

Рисуйте графику или текст артефакта между BeginArtifact и парным вызовом EndArtifact

Синтаксис

Delphi

Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;

DLL

int DLBeginArtifactA(int InstanceID, const char * SubType);

Параметры

SubType	Необязательное имя подтипа артефакта. Частые значения: `Header`, `Footer`, `Watermark`, `Background`. Пустая строка опускает подтип

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

0	Failed (no document is open)
1	Artifact region opened successfully

Пример

// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;