CapturePageEx

Paginamanipulatie

Beschrijving

Deze functie "vangt" een pagina. Nadat de pagina is vastgelegd, kan ze op andere pagina's worden getekend. Dit is nuttig om verschillende pagina's te combineren of om meer dan één originele pagina op een andere pagina te plaatsen (impositie). Nadat een pagina is vastgelegd, wordt ze uit het document verwijderd. Wil je dat de pagina in het document blijft, maak dan een lege pagina aan en teken de vastgelegde pagina daarop

Bovendien kan een pagina niet worden vastgelegd als ze de enige pagina van het document is, omdat een document te allen tijde ten minste één pagina moet hebben. In dat geval moet je eerst een nieuwe lege pagina toevoegen voordat de bestaande pagina kan worden vastgelegd

CapturePageEx verwijdert de vastgelegde pagina uit het huidige document; gebruik ImportPageAsFormXObject om de bronpagina te behouden of haar uit een ander open document te importeren

De "media box" van de pagina wordt als omvattende rechthoek voor de vastgelegde pagina gebruikt. De functie CapturePageEx kan worden gebruikt wanneer in plaats daarvan de "crop box" van de pagina gebruikt moet worden

Syntaxis

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

Parameters

Page	Het nummer van de pagina die moet worden vastgelegd. De eerste pagina in het document is pagina 1
Options	0 = Gebruik de media box van de pagina als omsluitende rechthoek 1 = Gebruik de crop box van de pagina als omsluitende rechthoek indien aanwezig, anders de media box 2 = Gebruik de bleed box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box 3 = Gebruik de trim box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box 4 = Gebruik de art box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box

Page

Het nummer van de pagina die moet worden vastgelegd. De eerste pagina in het document is pagina 1

Options

0 = Gebruik de media box van de pagina als omsluitende rechthoek 1 = Gebruik de crop box van de pagina als omsluitende rechthoek indien aanwezig, anders de media box 2 = Gebruik de bleed box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box 3 = Gebruik de trim box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box 4 = Gebruik de art box van de pagina als omsluitende rechthoek indien aanwezig, anders de crop box

Retourwaarden

0	De opgegeven pagina bestaat niet, of het is de enige pagina in het document
Non-zero	De ID van het vastleggingsproces. Deze ID moet aan de functie DrawCapturedPage worden doorgegeven