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

PageSidenummeret som skal fanges. Den første siden i dokumentet er side 1

Returverdier

0Den angitte siden finnes ikke, eller den er den eneste siden i dokumentet
Non-zeroID-en til fangstprosessen. Denne ID-en må sendes til DrawCapturedPage-funksjonen