Fungsi SetInputScopes2 (inputscope.h)

Artikel
08/24/2023

Aplikasi harus memanggil SetInputScope dengan IS_DEFAULT sebelum jendela dihancurkan untuk menghapus referensi antarmuka.

Sintaks

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parameter

[in] hwnd

Jendela untuk mengatur cakupan. Panggilan ini akan menggantikan cakupan apa pun yang mungkin telah ada di hwnd sebelumnya.

[in] pInputScopes

Penunjuk ke array cakupan input. Mungkin NULL. Jika tidak NULL, semua cakupan yang terkandung di dalamnya akan ditetapkan sebagai cakupan input hwnd dengan pembobotan yang sama. Gunakan IS_DEFAULT untuk menerima semua input lain juga (ini adalah opsi "jangan memaksa").

[in] cInputScopes

Hitungan jumlah cakupan input dalam pInputScopes. Harus nol jika rgScopes adalah NULL, harus bukan nol jika pInputScopes bukan NULL.

[in] pEnumString

Penunjuk antarmuka IenumString dari daftar frasa.

[in] pszRegExp

Penunjuk ke string yang dihentikan NULL yang menjelaskan ekspresi reguler yang akan dikenali. Mungkin NULL.

[in] pszSRGS

Penunjuk ke string XML yang dihentikan NULL yang menyediakan petunjuk dan aturan khusus ucapan untuk membantu pengenalan ucapan. Format XML sesuai dengan standar Spesifikasi Tata Bahasa Pengenalan Ucapan (SRGS), yang diuraikan di http://www.w3.org/TR/speech-grammar. Bisa NULL. $

Menampilkan nilai

Nilai	Makna
S_OK	Cakupan input berhasil diatur atau dibersihkan.

Keterangan

Aplikasi harus memanggil SetInputScope dengan IS_DEFAULT sebelum jendela dihancurkan untuk menghapus referensi antarmuka.

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 merespons perubahan cakupan.

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

Bagikan melalui