CapturePageEx

Manipulasi halaman

Deskripsi

Fungsi ini "meng-capture" sebuah halaman. Setelah halaman di-capture, ia bisa digambar ke halaman-halaman lain. Ini berguna untuk menggabungkan halaman-halaman berbeda atau untuk menempatkan lebih dari satu halaman asli ke satu halaman lain (imposition). Setelah halaman di-capture, ia dihapus dari dokumen. Bila Anda ingin halaman tetap berada di dokumen, Anda harus membuat halaman kosong dan menggambar halaman hasil capture ke halaman kosong itu

Selain itu, karena sebuah dokumen harus selalu punya minimal satu halaman, halaman tidak bisa di-capture bila ia satu-satunya halaman di dokumen. Dalam kasus ini, Anda harus menambahkan halaman kosong baru sebelum halaman yang ada bisa di-capture

CapturePageEx menghapus halaman yang di-capture dari dokumennya saat ini; pakai ImportPageAsFormXObject untuk mempertahankan halaman sumber atau mengimpornya dari dokumen terbuka lain

"Media box" halaman dipakai sebagai rectangle pembatas untuk halaman yang di-capture. Fungsi CapturePageEx bisa dipakai saat "crop box" halaman yang seharusnya dipakai

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);

Parameter

Page	Nomor halaman yang akan direkam. Halaman pertama dalam dokumen adalah halaman 1
Options	0 = Memakai media box halaman sebagai persegi pembatas 1 = Memakai crop box halaman sebagai persegi pembatas bila ada, jika tidak memakai media box 2 = Memakai bleed box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box 3 = Memakai trim box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box 4 = Memakai art box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box

Page

Nomor halaman yang akan direkam. Halaman pertama dalam dokumen adalah halaman 1

Options

0 = Memakai media box halaman sebagai persegi pembatas 1 = Memakai crop box halaman sebagai persegi pembatas bila ada, jika tidak memakai media box 2 = Memakai bleed box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box 3 = Memakai trim box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box 4 = Memakai art box halaman sebagai persegi pembatas bila ada, jika tidak memakai crop box

Nilai yang dikembalikan

0	Halaman yang ditentukan tidak ada, atau halaman itu satu-satunya halaman dalam dokumen
Non-zero	ID proses perekaman. ID ini harus diberikan ke fungsi DrawCapturedPage