CapturePage

Przetwarzanie stron

Opis

Ta funkcja "przechwytuje" stronę. Po przechwyceniu stronę można rysować na innych stronach. Jest to przydatne do łączenia różnych stron albo umieszczania więcej niż jednej strony oryginalnej na innej stronie (impozycja). Po przechwyceniu strona zostaje usunięta z dokumentu. Aby pozostawić ją w dokumencie, trzeba utworzyć pustą stronę i narysować na niej przechwyconą stronę.

Ponadto dokument musi zawsze zawierać co najmniej jedną stronę, dlatego nie można przechwycić strony, jeżeli jest jedyną stroną w dokumencie. W takim przypadku przed przechwyceniem istniejącej strony należy dodać nową pustą stronę.

Funkcja CapturePage nie pozwala przenosić stron z jednego dokumentu do innego nowego dokumentu, dlatego wszystkie wymagane strony trzeba scalić w jednym dokumencie przed wywołaniem CapturePage. CaptureID jest tylko wskaźnikiem do ukrytej strony, więc nie trzeba zwalniać pamięci.

Pole "media box" strony jest używane jako prostokąt ograniczający przechwyconą stronę. Funkcji CapturePage można użyć w przypadkach, gdy zamiast niego powinno zostać użyte pole "crop box" strony.

Składnia

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Parametry

Wartości zwracane