CapturePage
Manipulacija stranicama
Opis
Ova funkcija "hvata" stranicu. Nakon što je stranica uhvaćena, može se iscrtati na druge stranice. To je korisno za spajanje različitih stranica ili za smještanje više izvornih stranica na drugu stranicu (impozicija). Nakon što je stranica uhvaćena, uklanja se iz dokumenta. Ako želite da stranica ostane u dokumentu, morate stvoriti praznu stranicu i uhvaćenu stranicu iscrtati na praznu stranicu.
Također, budući da dokument u svakom trenutku mora imati barem jednu stranicu, nije moguće uhvatiti stranicu ako je ona jedina stranica u dokumentu. U tom slučaju morate dodati novu praznu stranicu prije nego što se postojeća stranica može uhvatiti.
CapturePage ne možete koristiti za premještanje stranica iz jednog dokumenta u novi dokument, pa sve potrebne stranice morate spojiti u jedan dokument prije poziva CapturePage. CaptureID je samo pokazivač na skrivenu stranicu, pa memoriju nije potrebno oslobađati.
Za uhvaćenu stranicu kao ograničavajući pravokutnik koristi se "media box" stranice. Funkcija CapturePage može se koristiti u slučajevima kada bi se umjesto toga trebao koristiti "crop box" stranice.
Sintaksa
Delphi
Function TPDFlib.CapturePage(Page: Integer): Integer;
ActiveX
Function PDFlib::CapturePage(Page As Long) As Long
DLL
int DLCapturePage(int InstanceID, int Page);
Parametri
| Page | Broj stranice koju treba uhvatiti. Prva stranica u dokumentu je stranica 1. |
|---|
Povratne vrijednosti
| 0 | Navedena stranica ne postoji ili je to jedina stranica u dokumentu |
|---|---|
| Nenula | ID procesa hvatanja. Taj ID mora se proslijediti funkciji DrawCapturedPage. |