CapturePage

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

Описание

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

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

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

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