CapturePageEx
Manipulacja stronami
Opis
Ta funkcja "przechwytuje" stronę. Po przechwyceniu strona może być rysowana na innych stronach. Jest to przydatne do łączenia różnych stron albo nakładania więcej niż jednej strony źródłowej na inną stronę (impozycja). Po przechwyceniu strona jest usuwana z dokumentu. Jeśli strona ma pozostać w dokumencie, musisz utworzyć pustą stronę i narysować przechwyconą stronę na tej pustej stronie.
Ponadto, ponieważ dokument musi mieć zawsze co najmniej jedną stronę, nie można przechwycić strony, jeśli jest jedyną stroną dokumentu. W takim przypadku musisz dodać nową pustą stronę, zanim będzie można przechwycić istniejącą stronę.
CapturePageEx usuwa przechwyconą stronę z jej bieżącego dokumentu; użyj ImportPageAsFormXObject, aby zachować stronę źródłową albo zaimportować ją z innego otwartego dokumentu
Jako prostokąt otaczający przechwyconej strony używany jest "media box" strony. Funkcji CapturePageEx można użyć w przypadkach, gdy zamiast niego należy użyć "crop box" strony.
Składnia
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As LongDLL
int DLCapturePageEx(int InstanceID, int Page, int Options);Parametry
| Page | Numer strony do przechwycenia. Pierwsza strona dokumentu to strona 1 |
|---|---|
| Options | 0 = użyj media box strony jako prostokąta ograniczającego 1 = użyj crop box strony, jeśli istnieje, w przeciwnym razie media box 2 = użyj bleed box strony, jeśli istnieje, w przeciwnym razie crop box 3 = użyj trim box strony, jeśli istnieje, w przeciwnym razie crop box 4 = użyj art box strony, jeśli istnieje, w przeciwnym razie crop box |
Wartości zwracane
| 0 | Podana strona nie istnieje albo jest jedyną stroną dokumentu |
|---|---|
| Non-zero | Identyfikator procesu przechwytywania. Ten identyfikator musi zostać przekazany do funkcji DrawCapturedPage |