CapturePageEx

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

Описание

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

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

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

"медийната рамка" на страницата се използва като обвивен правоъгълник за заснетата страница. Функцията 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
Options	0 = Използва се media box на страницата за ограждащ правоъгълник 1 = Използва се crop box на страницата за ограждащ правоъгълник, ако има такъв, иначе media box 2 = Използва се bleed box на страницата за ограждащ правоъгълник, ако има такъв, иначе crop box 3 = Използва се trim box на страницата за ограждащ правоъгълник, ако има такъв, иначе crop box 4 = Използва се art box на страницата за ограждащ правоъгълник, ако има такъв, иначе crop box

Page

Номерът на страницата за улавяне. Първата страница в документа е страница 1

Options

0 = Използва се 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	Идентификаторът на процеса на улавяне. Този ID трябва да се подаде на функцията DrawCapturedPage