DASetPageBox

Функции прямого доступа, свойства страницы

Описание

Задаёт размеры граничных прямоугольников указанной страницы; MediaBox представляет физический носитель страницы

CropBox определяет видимую область страницы, содержимое обрезается по ней. BleedBox похож на CropBox, но это прямоугольник, используемый в тиражном производстве

TrimBox задаёт предполагаемые размеры готовой страницы после обрезки, а ArtBox определяет границы значимого содержимого страницы по замыслу её создателя

Поведение по версиям PDF: записи страницы BleedBox, TrimBox и ArtBox требуют PDF 1.3. Когда Direct Access изменяет источник более низкой версии, а версия сохранения не закреплена, DASetPageBox поднимает заголовок сохраняемого документа до PDF 1.3, чтобы он соответствовал новым граничным боксам

Синтаксис

Delphi

Function TPDFlib.DASetPageBox(FileHandle, PageRef, BoxIndex: Integer; X1, Y1, X2, Y2: Double): Integer;

ActiveX

Function PDFlib::DASetPageBox(FileHandle As Long, PageRef As Long, BoxIndex As Long, X1 As Double, Y1 As Double, X2 As Double, Y2 As Double) As Long

DLL

int DLDASetPageBox(int InstanceID, int FileHandle, int PageRef, int BoxIndex, double X1, double Y1, double X2, double Y2);

Параметры

FileHandle	Дескриптор, возвращаемый функциями DAOpenFile, DAOpenFileReadOnly или DAOpenFromStream
PageRef	Ссылка на страницу, возвращаемая функциями DAFindPage или DANewPage
BoxIndex	1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1	Горизонтальная координата левого нижнего угла блока в пунктах от левого края страницы
Y1	Вертикальная координата нижнего левого угла рамки в точках от нижнего края страницы
X2	Горизонтальная координата правого верхнего угла блока в пунктах от низа страницы
Y2	Вертикальная координата правого верхнего угла блока в пунктах от низа страницы

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

0	Недопустимы параметры FileHandle или PageRef
1	Success