CapturePage

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

Описание

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

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

CapturePage не переносит страницы в другой новый документ, поэтому перед её вызовом все нужные страницы надо объединить в один документ. CaptureID — лишь указатель на скрытую страницу, освобождать память не нужно

Ограничивающим прямоугольником захваченной страницы служит "media box" страницы; если нужен "crop box", используйте функцию CapturePage

Синтаксис

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Параметры

PageНомер захватываемой страницы; первая страница документа — 1

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

0Указанной страницы нет либо она единственная в документе
Non-zeroID процесса захвата; он передаётся функции DrawCapturedPage