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 |