Fungsi SetInputScope (inputscope.h)

Mengatur cakupan input untuk jendela yang ditentukan.

Sintaks

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Parameter

[in] hwnd

Jendela untuk mengatur cakupan.

[in] inputscope

Cakupan input untuk dikaitkan dengan jendela. Untuk menghapus asosiasi cakupan input, teruskan IS_DEFAULT ke parameter ini.

Nilai kembali

Nilai	Makna
S_OK	Metode berhasil.

Keterangan

Memanggil metode ini menggantikan cakupan apa pun yang terkait dengan jendela.

Aplikasi harus memanggil metode ini, meneruskan IS_DEFAULT ke parameter hwnd , untuk menghapus asosiasi cakupan input sebelum jendela dihancurkan.

API ini hanya berfungsi ketika jendela (parameter hwnd ) dan utas panggilan berada di utas yang sama. Jika Anda memanggil API ini untuk jendela utas yang berbeda, api gagal dengan E_INVALIDARG.

Jika Anda memanggil metode ini pada jendela (parameter hwnd ) yang belum dikaitkan dengan Manajer Dokumen, maka tidak ada pemberitahuan layanan teks yang dikirim ke klien yang tertarik (seperti keyboard sentuh) yang mungkin ingin menanggapi perubahan cakupan.

Contoh

[C++]

Kode berikut menggambarkan cara mengatur cakupan input untuk jendela.

SetInputScope(hwnd, IS_EMAIL_USERNAME);

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	inputscope.h
DLL	Msctf.dll