CapturePageEx

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

Описание

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

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

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

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