CapturePage
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 ønsker at siden skal forbli i dokumentet, må du opprette en blank side og tegne den fangede siden på den blanke siden
Også, siden et dokument alltid 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
Du kan ikke bruke CapturePage til å flytte sider fra ett dokument til et annet nytt dokument, så alle nødvendige sider må slås sammen til ett dokument før CapturePage kalles. CaptureID-en er bare en peker til en skjult side, så minnet trenger ikke frigjøres
Sidens "media box" brukes som avgrensende rektangel for den fangede siden. CapturePage-funksjonen kan brukes i tilfeller der sidens "crop box" bør brukes i stedet
Syntaks
Delphi
Function TPDFlib.CapturePage(Page: Integer): Integer;
ActiveX
Function PDFlib::CapturePage(Page As Long) As Long
DLL
int DLCapturePage(int InstanceID, int Page);
Parametere
| Page | Sidenummeret som skal fanges. Den første siden i dokumentet er side 1 |
|---|
Returverdier
| 0 | Den angitte siden finnes ikke, eller den er den eneste siden i dokumentet |
|---|---|
| Non-zero | ID-en til fangstprosessen. Denne ID-en må sendes til DrawCapturedPage-funksjonen |