CapturePage

Sidemanipulation

Beskrivelse

Denne funktion "registrerer" en side. Når siden er registreret, kan den tegnes på andre sider. Dette er nyttigt til at kombinere forskellige sider eller placere mere end én oprindelig side på en anden side (udskydning). Når en side er registreret, fjernes den fra dokumentet. Hvis siden skal forblive i dokumentet, skal du oprette en tom side og tegne den registrerede side på den tomme side.

Da et dokument altid skal have mindst én side, er det heller ikke muligt at registrere en side, hvis den er dokumentets eneste side. I så fald skal du tilføje en ny tom side, før den eksisterende side kan registreres.

Du kan ikke bruge CapturePage til at flytte sider fra et dokument til et andet nyt dokument, så alle nødvendige sider skal flettes til ét dokument, før CapturePage kaldes. CaptureID er blot en markør til en skjult side, og derfor skal hukommelsen ikke frigives.

Sidens "media box" bruges som afgrænsningsrektangel for den indfangede side. Funktionen CapturePage kan bruges i tilfælde, hvor sidens "crop box" i stedet skal anvendes.

Syntaks

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Parametre

Returværdier