Metode IInkOverlay::SetWindowInputRectangle (msinkaut.h)

Mengatur persegi jendela, dalam piksel, di mana tinta digambar.

Sintaks

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Parameter

[in] WindowInputRectangle

Persegi panjang, dalam koordinat jendela, tempat tinta digambar.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_INVALIDARG	Koordinat persegi panjang tidak valid (misalnya, lebar/tinggi 0).
E_INK_COLLECTOR_BUSY	Tidak dapat memperbarui pemetaan saat berada di tengah stroke.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_INK_OVERLAPPING_INPUT_RECT	Persegi panjang input jendela tumpang tindih dengan persegi panjang input jendela dari InkCollector yang diaktifkan.

Keterangan

Kesalahan E_INK_OVERLAPPING_INPUT_RECT dikembalikan jika persegi panjang input jendela dari pengumpul tinta yang diaktifkan (diatur dengan properti Diaktifkan ) tumpang tindih dengan persegi panjang input jendela dari pengumpul tinta lain yang diaktifkan.

Catatan Tumpang tindih dapat terjadi tanpa kesalahan selama hanya salah satu persegi panjang input yang diaktifkan pada waktu yang diketahui.

 

Secara default, persegi panjang input jendela diatur ke {0,0,0,0}. Persegi panjang default ini memetakan ke ukuran seluruh jendela.

Untuk mengatur ulang persegi panjang input jendela ke perilaku defaultnya (persegi panjang kosong dengan koordinat {0,0,0,0}), teruskan {0,0,0,0} panggilan ke SetWindowInputRectangle, dan bukan NULL.

Anda tidak dapat meneruskan persegi panjang di mana nilai properti Kanan kurang dari nilai properti Kiri ; atau di mana nilai properti Bawah kurang dari nilai properti Atas . Misalnya, persegi panjang dengan parameter {500, 500, 400, 400} tidak valid.

Hati Jika Anda mengatur persegi panjang input jendela untuk menumpuk kontrol pemisah atau batas jendela, hasil yang tidak dapat diprediksi dapat terjadi saat jendela diubah ukurannya.

 

Catatan Memanggil metode ini dalam penangan pesan tertentu dapat mengakibatkan fungsi yang mendasar dimasukkan kembali, menyebabkan hasil yang tidak terduga. Berhati-hatilah untuk menghindari panggilan masuk kembali saat menangani salah satu pesan berikut: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND jika wParam diatur ke SC_HOTKEY atau SC_TASKLIST; dan WM_SYSKEYDOWN (saat memproses kombinasi tombol Alt+TAB atau Alt+ESC). Ini adalah masalah dengan aplikasi model apartemen berulir tunggal.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll

Lihat juga

Properti Diaktifkan

Metode GetWindowInputRectangle

IInkOverlay

Kelas InkOverlay