DACapturePage

Funkcje dostępu bezpośredniego, Przetwarzanie stron

Opis

Ta funkcja "przechwytuje" podaną stronę z dokumentu otwartego pierwotnie funkcją DAOpenFile. Przechwyconą stronę można następnie narysować na dowolnej innej stronie za pomocą funkcji DADrawCapturedPage. 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ę.

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

Składnia

Delphi

Function TPDFlib.DACapturePage(FileHandle, PageRef: Integer): Integer;

ActiveX

Function PDFlib::DACapturePage(FileHandle As Long, PageRef As Long) As Long

DLL

int DLDACapturePage(int InstanceID, int FileHandle, int PageRef);

Parametry

FileHandleUchwyt zwrócony przez funkcję DAOpenFile, DAOpenFileReadOnly lub DAOpenFromStream
PageRefOdwołanie do strony zwrócone przez funkcję DAFindPage lub DANewPage

Wartości zwracane

0Podany FileHandle lub PageRef był nieprawidłowy
Wartość niezerowaIdentyfikator, którego można użyć z funkcją DADrawCapturedPage