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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk