CapturePageEx
Sidemanipulering
Beskrivelse
Denne funksjonen "fanger" en side. Når siden er fanget kan den tegnes på andre sider. Dette er nyttig for å kombinere ulike sider eller for å plassere mer enn én originalside på en annen side (imposisjon). Når en side er fanget fjernes den fra dokumentet. Hvis du vil at siden skal forbli i dokumentet, må du opprette en blank side og tegne den fangede siden på den blanke siden
I tillegg, siden et dokument til enhver tid må ha minst én side, er det ikke mulig å fange en side hvis den er den eneste siden i dokumentet. I så fall må du legge til en ny blank side før den eksisterende siden kan fanges
CapturePageEx fjerner den fangede siden fra sitt nåværende dokument; bruk ImportPageAsFormXObject for å bevare kildesiden eller importere den fra et annet åpent dokument
Sidens "media box" brukes som avgrensningsrektangel for den fangede siden. Funksjonen CapturePageEx kan brukes i tilfeller der sidens "crop box" bør brukes i stedet
Syntaks
Delphi
Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;
ActiveX
Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long
DLL
int DLCapturePageEx(int InstanceID, int Page, int Options);
Parametere
| Page | Sidenummeret som skal fanges. Første side i dokumentet er side 1 |
|---|---|
| Options | 0 = Bruk sidens media box som avgrensende rektangel 1 = Bruk sidens crop box som avgrensende rektangel hvis den har en, ellers bruk media box 2 = Bruk sidens bleed box som avgrensende rektangel hvis den har en, ellers bruk crop box 3 = Bruk sidens trim box som avgrensende rektangel hvis den har en, ellers bruk crop box 4 = Bruk sidens art box som avgrensende rektangel hvis den har en, ellers bruk crop box |
Returverdier
| 0 | Den angitte siden finnes ikke, eller den er eneste side i dokumentet |
|---|---|
| Non-zero | ID-en til fangstprosessen. Denne ID-en må oppgis til DrawCapturedPage-funksjonen |