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
| FileHandle | Uchwyt zwrócony przez funkcję DAOpenFile, DAOpenFileReadOnly lub DAOpenFromStream |
|---|---|
| PageRef | Odwołanie do strony zwrócone przez funkcję DAFindPage lub DANewPage |
Wartości zwracane
| 0 | Podany FileHandle lub PageRef był nieprawidłowy |
|---|---|
| Wartość niezerowa | Identyfikator, którego można użyć z funkcją DADrawCapturedPage |