CapturePageEx

Sidmanipulering

Beskrivning

Denna funktion "fångar" en sida. När sidan har fångats kan den ritas på andra sidor. Detta är användbart för att kombinera olika sidor eller för att placera mer än en originalsida på en annan sida (imposition). När en sida har fångats tas den bort ur dokumentet. Om du vill att sidan ska finnas kvar i dokumentet måste du skapa en tom sida och rita den fångade sidan på den tomma sidan

Eftersom ett dokument alltid måste ha minst en sida är det inte möjligt att fånga en sida om den är den enda sidan i dokumentet. I så fall måste du lägga till en ny tom sida innan den befintliga sidan kan fångasCapturePageEx tar bort den fångade sidan ur dess aktuella dokument; använd

ImportPageAsFormXObject för att bevara källsidan eller för att importera den från ett annat öppet dokument

Sidans "media box" används som begränsningsrektangel för den fångade sidan. Funktionen CapturePageEx kan användas i de fall sidans "crop box" i stället ska användas

Syntax

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);

Parametrar

Page	Sidnumret som ska fångas. Första sidan i dokumentet är sida 1
Options	0 = Använd sidans media box som begränsningsrektangel 1 = Använd sidans crop box som begränsningsrektangel om den har en, i annat fall media box 2 = Använd sidans bleed box som begränsningsrektangel om den har en, i annat fall crop box 3 = Använd sidans trim box som begränsningsrektangel om den har en, i annat fall crop box 4 = Använd sidans art box som begränsningsrektangel om den har en, i annat fall crop box

Page

Sidnumret som ska fångas. Första sidan i dokumentet är sida 1

Options

0 = Använd sidans media box som begränsningsrektangel 1 = Använd sidans crop box som begränsningsrektangel om den har en, i annat fall media box 2 = Använd sidans bleed box som begränsningsrektangel om den har en, i annat fall crop box 3 = Använd sidans trim box som begränsningsrektangel om den har en, i annat fall crop box 4 = Använd sidans art box som begränsningsrektangel om den har en, i annat fall crop box

Returvärden

0	Den angivna sidan finns inte, eller så är det dokumentets enda sida
Non-zero	ID:t för fångstprocessen. Detta ID måste skickas till funktionen DrawCapturedPage