WIA_DPS_PAGE_SIZE
Properti WIA_DPS_PAGE_SIZE berisi ukuran halaman yang saat ini dipilih untuk dipindai.
Jenis Properti: VT_I4
Nilai yang Valid: WIA_PROP_LIST
Hak Akses: Baca/tulis
Keterangan
Untuk memilih dimensi halaman yang akan dipindai, aplikasi mengatur WIA_DPS_PAGE_SIZE. Minidriver WIA membuat dan memelihara properti ini.
Tabel berikut ini menjelaskan konstanta yang valid dengan WIA_IPS_PAGE_SIZE.
| Nilai | Definisi |
|---|---|
| WIA_PAGE_A4 | Ukuran halaman adalah 8267 × 11692 (orientasi PORTRAIT). |
| WIA_PAGE_CUSTOM | Ukuran halaman ditentukan oleh nilai properti WIA_DPS_PAGE_HEIGHT dan WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | Ukuran halaman adalah 8500 × 11000 (orientasi PORTRAIT). |
Nilai properti WIA_IPS_ORIENTATION menentukan orientasi halaman yang saat ini dipilih. Properti WIA_DPS_PAGE_WIDTH dan WIA_DPS_PAGE_HEIGHT melaporkan dimensi halaman, dalam seribu inci (.001). Properti ini harus memiliki nilai yang setara dengan properti WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT , yang berisi dimensi halaman, dalam piksel.
Nilai yang diketik WIA_PROP_LIST harus bergantung pada pengaturan properti WIA_IPS_ORIENTATION yang valid. Jika perangkat tidak dapat memindai dokumen berorientasi lanskap dengan pengaturan WIA_PAGE_A4, WIA_PAGE_A4 tidak boleh muncul dalam daftar nilai yang valid untuk properti WIA_DPS_PAGE_SIZE saat WIA_IPS_ORIENTATION diatur ke LANSKAP.
Jika aplikasi menetapkan WIA_DPS_PAGE_SIZE ke nilai apa pun selain WIA_PAGE_CUSTOM, minidriver harus menyesuaikan nilai WIA_DPS_PAGE_WIDTH dan WIA_DPS_PAGE_HEIGHT ke dimensi halaman, dalam seperseribu inci (.001). Minidriver juga harus menyesuaikan nilai WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT ke dimensi halaman, dalam piksel.
Jika pengaturan jangkauan (WIA_IPS_XEXTENT atau WIA_IPS_YEXTENT) diubah menjadi nilai yang tidak cocok dengan pengaturan ukuran halaman saat ini, minidriver harus mengubah nilai properti WIA_DPS_PAGE_SIZE menjadi WIA_PAGE_CUSTOM. Minidriver juga harus memodifikasi WIA_DPS_PAGE_WIDTH atau WIA_DPS_PAGE_HEIGHT sesuai dengan pengaturan tingkat baru.
Jika WIA_IPS_ORIENTATION diatur ke LANSKAP, pengaturan jangkauannya akan "dibalik." Misalnya, jika aplikasi mengatur WIA_DPS_PAGE_SIZE ke WIA_PAGE_A4, minidriver harus mengatur WIA_DPS_PAGE_WIDTH ke 11692 dan WIA_DPS_PAGE_HEIGHT ke 8267. (Minidriver juga harus mengatur WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT yang sesuai.) Perhatikan bahwa jika WIA_DPS_PAGE_SIZE diatur ke WIA_PAGE_CUSTOM, pengaturan orientasi tidak digunakan untuk menentukan dimensi halaman yang akan dipindai.
Minidriver harus memastikan bahwa properti WIA_IPS_ORIENTATION setuju dengan area pilihan saat ini. Jika aplikasi mengubah nilai WIA_IPS_ORIENTATION menjadi salah satu yang tidak valid untuk ukuran halaman yang saat ini dipilih, minidriver harus mengubah nilai WIA_DPS_PAGE_SIZE menjadi ukuran halaman yang didukung oleh nilai orientasi baru.
Jika aplikasi mengatur properti WIA_DPS_PAGE_SIZE ke WIA_PAGE_CUSTOM, area pilihan saat ini tidak terpengaruh. Minidriver WIA harus mendapatkan tata letak gambar saat ini, mulai dari pengaturan properti WIA_IPS_XPOS dan WIA_IPS_YPOS saat ini. Jika pengaturan ukuran halaman menghasilkan area pilihan yang berada di luar tempat tidur pemindai, minidriver harus secara otomatis menyesuaikan nilai properti WIA_IPS_XPOS dan WIA_IPS_YPOS ke pengaturan yang valid. Jika properti WIA_DPS_PAGE_SIZE dan WIA_IPS_ORIENTATION diatur pada saat yang sama dan tidak valid ketika diterapkan dalam kombinasi, minidriver harus gagal dalam pengaturan aplikasi dengan mengembalikan kesalahan dalam metode IWiaMiniDrv::d rvValidateItemProperties .
Empat contoh kode berikut menunjukkan skenario WIA_DPS_PAGE_SIZE berikut:
Driver melaporkan pengaturan.
Aplikasi mengatur properti WIA_DPS_PAGE_SIZE ke WIA_PAGE_LETTER.
Aplikasi mengatur properti WIA_IPS_ORIENTATION ke LANSKAP.
Aplikasi mengubah properti WIA_IPS_XEXTENT menjadi nilai yang lebih kecil.
Contoh 1: Minidriver melaporkan pengaturan
Dalam contoh kode berikut, minidriver mengatur area pilihan kustom sebelum aplikasi mengatur properti WIA apa pun. Dalam hal ini, area pilihan mewakili seluruh flatbed.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = WIA_IPS_XPOS POTRET = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Contoh 2: Aplikasi mengatur properti WIA_DPS_PAGE_SIZE ke WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = WIA_IPS_XPOS POTRET = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Contoh 3: Aplikasi mengatur properti WIA_IPS_ORIENTATION ke LANSKAP
Tempat tidur fisik harus dapat memperoleh halaman yang awalnya dalam orientasi lanskap.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = WIA_IPS_XPOS LANSKAP = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Contoh 4: Aplikasi mengubah properti WIA_IPS_XEXTENT menjadi nilai yang lebih kecil
Dalam contoh kode berikut, aplikasi mengubah properti WIA_IPS_XEXTENT menjadi 1000. Minidriver harus mengasumsikan bahwa nilai baru untuk WIA_IPS_XEXTENT tidak lagi valid untuk properti WIA_DPS_PAGE_SIZE dan dengan demikian harus mengubah WIA_DPS_PAGE_SIZE menjadi WIA_PAGE_CUSTOM. Minidriver juga harus menyesuaikan WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = WIA_IPS_XPOS LANSKAP = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Persyaratan
Versi: Usang, gunakan properti WIA_IPS_PAGE_SIZE sebagai gantinya.
Header: wiadef.h (termasuk Wiadef.h)
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk