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