CapturePage

Paginamanipulatie

Beschrijving

Deze functie legt een pagina vast. Zodra de pagina is vastgelegd, kan deze op andere pagina's worden getekend. Dit is nuttig voor het combineren van verschillende pagina's of voor het plaatsen van meer dan één originele pagina op een andere pagina (impositie). Zodra een pagina is vastgelegd, wordt deze uit het document verwijderd. Wil u dat de pagina in het document blijft, maak dan een lege pagina aan en teken de vastgelegde pagina op die lege pagina

Ook geldt: omdat een document altijd minstens één pagina moet hebben, kan een pagina niet worden vastgelegd als het de enige pagina in het document is. In dat geval moet u eerst een nieuwe lege pagina toevoegen voordat de bestaande pagina kan worden vastgelegd

Met CapturePage kunt u geen pagina's van het ene naar een ander nieuw document verplaatsen, dus alle benodigde pagina's moeten eerst in één document worden samengevoegd voordat u CapturePage aanroept. De CaptureID is slechts een pointer naar een verborgen pagina, dus het geheugen hoeft niet te worden vrijgegeven

De "media box" van de pagina wordt als omsluitende rechthoek voor de vastgelegde pagina gebruikt. In gevallen waar in plaats daarvan de "crop box" van de pagina gebruikt moet worden, kan de functie CapturePage worden gebruikt

Syntaxis

Delphi

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

ActiveX

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

DLL

int DLCapturePage(int InstanceID, int Page);

Parameters

Retourwaarden