CapturePageEx
Puslapių tvarkymas
Aprašymas
Ši funkcija „užfiksuoja“ puslapį. Kai puslapis užfiksuotas, jį galima piešti ant kitų puslapių. Tai naudinga jungiant skirtingus puslapius arba dedant daugiau nei vieną originalų puslapį ant kito puslapio (impozicija). Kai puslapis užfiksuotas, jis pašalinamas iš dokumento. Jei norite, kad puslapis liktų dokumente, turite sukurti tuščią puslapį ir užfiksuotąjį puslapį nupiešti ant to tuščiojo puslapioBe to, kadangi dokumentas visuomet turi turėti bent vieną puslapį, neįmanoma užfiksuoti puslapio, jei jis yra vienintelis dokumento puslapis. Tokiu atveju prieš užfiksuojant esamą puslapį turite pridėti naują tuščią puslapįCapturePageEx pašalina užfiksuotąjį puslapį iš jo dabartinio dokumento; naudokite
Be to, kadangi dokumentas bet kada turi turėti bent vieną puslapį, puslapio užfiksuoti negalima, jei jis vienintelis dokumente. Tokiu atveju prieš užfiksuojant esamąjį puslapį turite pridėti naują tuščiąjį puslapį
ImportPageAsFormXObject, kad išsaugotumėte šaltinio puslapį, arba importuokite jį iš kito atverto dokumentoKaip užfiksuotojo puslapio apibrėžiantis stačiakampis naudojama puslapio „media box“. CapturePageEx funkciją galima naudoti tais atvejais, kai vietoj jos turėtų būti naudojama puslapio „crop box“
Puslapio "media box" naudojamas kaip ribinis stačiakampis užfiksuotajam puslapiui. Funkciją CapturePageEx galima naudoti tada, kai vietoje to turėtų būti naudojama puslapio "crop box".
Sintaksė
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);
Parametrai
| Page | Užfiksuotino puslapio numeris. Pirmasis dokumento puslapis yra 1 puslapis |
|---|---|
| Options | 0 = apibrėžiančiajam stačiakampiui naudojama puslapio media box 1 = apibrėžiančiajam stačiakampiui naudojama puslapio crop box, jei ji yra, kitu atveju media box 2 = apibrėžiančiajam stačiakampiui naudojama puslapio bleed box, jei ji yra, kitu atveju crop box 3 = apibrėžiančiajam stačiakampiui naudojama puslapio trim box, jei ji yra, kitu atveju crop box 4 = apibrėžiančiajam stačiakampiui naudojama puslapio art box, jei ji yra, kitu atveju crop box |
Grąžinamos reikšmės
| 0 | Nurodyto puslapio nėra arba jis yra vienintelis dokumento puslapis |
|---|---|
| Non-zero | Fiksavimo proceso ID. Šis ID turi būti pateikiamas DrawCapturedPage funkcijai |