Metode IInkCollector::get_Enabled (msinkaut.h)

Artikel
08/24/2023

Mendapatkan atau menetapkan nilai yang menentukan apakah objek InkCollector mengumpulkan input pena (paket dalam udara, kursor dalam peristiwa rentang, dan sebagainya).

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_Enabled(
  VARIANT_BOOL *Collecting
);

Parameter

Collecting

Nilai kembali

Tidak ada

Keterangan

Jika persegi panjang input jendela objek yang diaktifkan (diatur dalam konstruktor atau dengan metode SetWindowInputRectangle ) dari objek yang diaktifkan tumpang tindih dengan persegi panjang input jendela dari objek lain yang diaktifkan, kesalahan E_INK_OVERLAPPING_INPUT_RECT dikembalikan. Tumpang tindih dapat terjadi tanpa kesalahan selama hanya salah satu persegi panjang input yang diaktifkan pada waktu yang diketahui.

Meskipun objek tidak diaktifkan, Anda tidak menerima peristiwa.

Ketika kontrol kontainer memiliki properti Diaktifkan yang diatur ke FALSE, semua kontrol yang terkandung juga dinonaktifkan.

Anda tidak dapat mengatur properti Diaktifkan ke FALSE saat objek mengumpulkan tinta (properti CollectingInk ADALAH TRUE).

Kami menyarankan agar Anda mengatur Diaktifkan diatur ke FALSE saat aplikasi dimatikan.

Catatan Mengatur properti 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 kunci Alt-Tab atau Alt-Esc). Ini adalah masalah dengan aplikasi model apartemen berulir tunggal.

Properti ini harus diatur ke FALSE sebelum mengatur atau memanggil properti dan metode objek tertentu. Jika Anda mencoba mengubah properti atau metode yang ditentukan, terjadi kesalahan. Properti dan metode berikut tidak dapat diatur atau dipanggil kecuali properti Diaktifkan pertama kali diatur ke FALSE:

Properti

Metode

Persyaratan


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