CapturePageEx

Манипуляция страницами

Описание

Эта функция "захватывает" страницу. После захвата страницу можно рисовать на других страницах. Это удобно для комбинирования разных страниц или для размещения более одной исходной страницы на другой странице (спуска полос). После захвата страница удаляется из документа. Если нужно, чтобы страница осталась в документе, создайте пустую страницу и нарисуйте захваченную страницу на ней

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

CapturePageEx удаляет захваченную страницу из ее текущего документа; используйте ImportPageAsFormXObject, чтобы сохранить исходную страницу или импортировать ее из другого открытого документа

В качестве ограничивающего прямоугольника захваченной страницы используется "media box" страницы. Функция CapturePageEx пригодится, когда вместо него следует использовать "crop box" страницы

Синтаксис

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

Параметры

PageНомер захватываемой страницы. Первая страница документа имеет номер 1
Options0 = использовать media box страницы в качестве ограничивающего прямоугольника 1 = использовать crop box страницы, если он есть, иначе media box 2 = использовать bleed box страницы, если он есть, иначе crop box 3 = использовать trim box страницы, если он есть, иначе crop box 4 = использовать art box страницы, если он есть, иначе crop box

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

0Указанная страница не существует либо является единственной страницей документа
Non-zeroИдентификатор процесса захвата. Этот идентификатор необходимо передать функции DrawCapturedPage