CapturePageEx
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.
CapturePageEx 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 CapturePageEx. 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 CapturePageEx može se koristiti u slučajevima kada bi se umjesto toga trebao koristiti "crop box" stranice.
Sintaksa
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);Parametri
| Page | Broj stranice koju treba uhvatiti. Prva stranica u dokumentu je stranica 1. |
|---|---|
| Options | 0 = Koristite media box stranice kao ograničavajući pravokutnik 1 = Koristite crop box stranice kao ograničavajući pravokutnik ako postoji, inače koristite media box 2 = Koristite bleed box stranice kao ograničavajući pravokutnik ako postoji, inače koristite crop box 3 = Koristite trim box stranice kao ograničavajući pravokutnik ako postoji, inače koristite crop box 4 = Koristite art box stranice kao ograničavajući pravokutnik ako postoji, inače koristite crop box |
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. |