CapturePageEx
Oldalkezelés
Leírás
Ez a függvény "eltérő" oldalt rögzít. Amint az oldal rögzítésre került, más oldalakra rajzolható. Ez hasznos különböző oldalak kombinálásához vagy egynél több eredeti oldal másik oldalra helyezéséhez (imposition). Amint az oldal rögzítésre került, eltávolításra kerül a dokumentumból. Ha azt szeretnéd, hogy az oldal a dokumentumban maradjon, üres oldalt kell létrehoznod, és arra rajzolni a rögzített oldalt
Mivel a 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áadni, mielőtt a meglévő oldal rögzíthető lenne
A CapturePageEx eltávolítja a rögzített oldalt az aktuális dokumentumából; használd az ImportPageAsFormXObject-ot a forrásoldal megőrzésére vagy egy másik nyitott dokumentumból való importálására
Az oldal "média dobozát" használja a rögzített oldal befoglaló téglalapjaként. Olyan esetekben használható a CapturePageEx függvény, amikor inkább az oldal "vágó dobozát" kellene használni
Szintaxis
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);
Paraméterek
| Page | A rögzítendő oldal száma. A dokumentum első oldala az 1. oldal |
|---|---|
| Options | 0 = Az oldal media box értékének használata határoló téglalapként 1 = Az oldal crop box értékének használata határoló téglalapként, ha van ilyen, egyébként a media boxé 2 = Az oldal bleed box értékének használata határoló téglalapként, ha van ilyen, egyébként a crop boxé 3 = Az oldal trim box értékének használata határoló téglalapként, ha van ilyen, egyébként a crop boxé 4 = Az oldal art box értékének használata határoló téglalapként, ha van ilyen, egyébként a crop boxé |
Visszatérési értékek
| 0 | A megadott oldal nem létezik, vagy ez az egyetlen oldal a dokumentumban |
|---|---|
| Non-zero | A rögzítési folyamat azonosítója. Ezt az azonosítót meg kell adni a DrawCapturedPage függvénynek |