CapturePage

Oldalmanipuláció

Leírás

Ez a függvény "rögzít" egy oldalt. A rögzítés után az oldal más oldalakra rajzolható. Ez különböző oldalak összeillesztéséhez vagy egynél több eredeti oldal másik oldalra helyezéséhez (íves összeállítás) hasznos. A rögzítés után az oldal eltávolításra kerül a dokumentumból. Ha az oldalnak a dokumentumban kell maradnia, üres oldalt kell létrehoznia, és a rögzített oldalt arra az üres oldalra kell rajzolnia

Mivel egy dokumentumnak mindig legalább egy oldallal kell rendelkeznie, nem lehet oldalt rögzíteni, ha az a dokumentum egyetlen oldala. Ebben az esetben új üres oldalt kell hozzáadnia, mielőtt a meglévő oldal rögzíthető lenne

A CapturePage nem használható oldalak áthelyezésére egyik dokumentumból egy másik új dokumentumba, ezért a szükséges oldalakat a CapturePage hívása előtt egyetlen dokumentumba kell egyesíteni. A CaptureID csupán egy rejtett oldalra mutató mutató, ezért memóriát nem kell felszabadítani

Az oldal "media box" értéke szolgál a rögzített oldal határoló téglalapjaként. A CapturePage függvény olyan esetekben használható, amikor helyette az oldal "crop box" értékét kell használni

Szintaxis

Delphi

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

ActiveX

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

DLL

int DLCapturePage(int InstanceID, int Page);

Paraméterek

Visszatérési értékek