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-zero | ID процесса захвата; он передаётся функции DrawCapturedPage |