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
| Page | Užfiksuotinas puslapio numeris. Pirmasis dokumento puslapis yra 1 puslapis |
|---|
Grąžinamos reikšmės
| 0 | Nurodytasis puslapis neegzistuoja arba jis vienintelis dokumente |
|---|---|
| Non-zero | Fiksavimo proceso ID. Šis ID turi būti pateikiamas DrawCapturedPage funkcijai |