CapturePage

Манипулиране на страници

Описание

Тази функция „заснема“ страница. След като страницата е заснета, тя може да бъде изчертавана върху други страници. Това е полезно за комбиниране на различни страници или за поставяне на повече от една оригинална страница върху друга страница (imposition). След като една страница бъде заснета, тя се премахва от документа. Ако искате страницата да остане в документа, трябва да създадете празна страница и да изчертаете заснетата страница върху празната страница

Освен това, тъй като документът трябва винаги да има поне една страница, не е възможно да заснемете страница, ако тя е единствената страница в документа. В този случай трябва да добавите нова празна страница, преди съществуващата страница да може да бъде заснета

Не можете да използвате CapturePage, за да премествате страници от един документ в друг нов документ, така че всички необходими страници трябва да бъдат обединени в един документ, преди да извикате CapturePage. CaptureID е само указател към скрита страница, затова паметта не трябва да се освобождава

Media box за страницата се използва като ограждащ правоъгълник за заснетата страница. Функцията CapturePage може да се използва в случаи, когато вместо това трябва да се използва crop box

Синтаксис

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Посочената страница не съществува или е единствената страница в документа
Ненулева стойностИдентификаторът на процеса на заснемане. Този идентификатор трябва да бъде подаден на функцията DrawCapturedPage