CapturePageEx
Sidemanipulation
Beskrivelse
Denne funktion "fanger" en side. Når siden er fanget, kan den tegnes på andre sider. Det er nyttigt til at kombinere forskellige sider eller placere mere end én original side på en anden side (imposition). Når en side er fanget, fjernes den fra dokumentet. Hvis siden skal forblive i dokumentet, skal du oprette en tom side og tegne den fangede side på den tomme side.
Desuden kan en side ikke fanges, hvis den er dokumentets eneste side, da et dokument til enhver tid skal have mindst én side. I så fald skal du tilføje en ny tom side, før den eksisterende side kan fanges.
CapturePageEx fjerner den fangede side fra dens nuværende dokument; brug ImportPageAsFormXObject for at bevare kildesiden eller importere den fra et andet åbent dokument
Sidens "media box" bruges som det ydre rektangel for den fangede side. Funktionen CapturePageEx kan bruges i tilfælde, hvor sidens "crop box" skal bruges i stedet.
Syntaks
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);Parametre
| Page | Sidenummeret, der skal fanges. Den første side i dokumentet er side 1 |
|---|---|
| Options | 0 = Brug sidens media box til det afgrænsende rektangel 1 = Brug sidens crop box til det afgrænsende rektangel, hvis den har en, ellers brug media box 2 = Brug sidens bleed box til det afgrænsende rektangel, hvis den har en, ellers brug crop box 3 = Brug sidens trim box til det afgrænsende rektangel, hvis den har en, ellers brug crop box 4 = Brug sidens art box til det afgrænsende rektangel, hvis den har en, ellers brug crop box |
Returværdier
| 0 | Den angivne side findes ikke, eller den er eneste side i dokumentet |
|---|---|
| Non-zero | Id'et for fangstprocessen. Dette id skal angives til funktionen DrawCapturedPage |