CapturePage

Puslapių tvarkymas

Aprašymas

Ši funkcija "užfiksuoją" puslapį. Užfiksavus puslapį jį galima piešti kituose puslapiuose. Tai naudinga skirtingiems puslapiams sujungti arba daugiau nei vienam originaliam puslapiui padėti ant kito puslapio (impozicija). Užfiksavus puslapį jis pašalinamas iš dokumento. Jei norite, kad puslapis liktų dokumente, turite sukurti tuščiąjį puslapį ir užfiksuotąjį puslapį nupiešti ant tuščiojo

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į

CapturePage negalima naudoti puslapiams perkelti iš vieno dokumento į kitą naująjį dokumentą, todėl visi reikiami puslapiai prieš iškviečiant CapturePage turi būti sujungti į vieną dokumentą. CaptureID yra tik rodyklė į paslėptąjį puslapį, todėl atminties atlaisvinti nereikia

Puslapio "media box" naudojamas kaip užfiksuotojo puslapio aprėpiantysis stačiakampis. CapturePage naudojama tuomet, kai vietoje to turėtų būti naudojama puslapio "crop box"

Sintaksė

Delphi

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

ActiveX

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

DLL

int DLCapturePage(int InstanceID, int Page);

Parametrai

PageUžfiksuotinas puslapio numeris. Pirmasis dokumento puslapis yra 1 puslapis

Grąžinamos reikšmės

0Nurodytasis puslapis neegzistuoja arba jis vienintelis dokumente
Non-zeroFiksavimo proceso ID. Šis ID turi būti pateikiamas DrawCapturedPage funkcijai