CapturePage
Manipulasi halaman
Deskripsi
Fungsi ini "menangkap" sebuah halaman. Setelah halaman di-capture, ia bisa digambar ke halaman-halaman lain. Ini berguna untuk menggabungkan halaman berbeda atau menempatkan lebih dari satu halaman asli ke satu halaman lain (imposition). Setelah halaman di-capture, ia dihapus dari dokumen. Jika ingin halaman tetap ada di dokumen, Anda harus membuat halaman kosong dan menggambar halaman hasil capture ke halaman kosong itu
Selain itu, karena dokumen harus selalu punya minimal satu halaman, halaman tidak bisa di-capture jika ia satu-satunya halaman di dokumen. Dalam kasus ini, Anda harus menambahkan halaman kosong baru sebelum halaman yang ada bisa di-capture
Anda tidak bisa memakai CapturePage untuk memindahkan halaman dari satu dokumen ke dokumen baru lain, jadi semua halaman yang dibutuhkan harus digabungkan dulu ke satu dokumen sebelum memanggil CapturePage. CaptureID hanyalah pointer ke halaman tersembunyi sehingga memorinya tidak perlu dilepaskan
"Media box" halaman dipakai sebagai rectangle pembatas untuk halaman hasil capture. Fungsi CapturePage bisa dipakai jika yang seharusnya dipakai adalah "crop box" halaman
Sintaks
Delphi
Function TPDFlib.CapturePage(Page: Integer): Integer;
ActiveX
Function PDFlib::CapturePage(Page As Long) As Long
DLL
int DLCapturePage(int InstanceID, int Page);
Parameter
| Page | Nomor halaman yang di-capture. Halaman pertama dalam dokumen adalah halaman 1 |
|---|
Nilai kembalian
| 0 | Halaman yang ditentukan tidak ada, atau ia satu-satunya halaman di dokumen |
|---|---|
| Non-zero | ID proses capture. ID ini harus diberikan ke fungsi DrawCapturedPage |