Fungsi SetInputScopes (inputscope.h)

Mengatur kombinasi satu cakupan input, beberapa cakupan input, satu daftar frasa, ekspresi reguler, dan/atau aturan Spesifikasi Tata Bahasa Pengenalan Ucapan (SRGS) untuk jendela yang ditentukan.

Sintaks

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parameter

[in] hwnd

Jendela untuk mengatur cakupan.

[in] pInputScopes

Penunjuk ke array cakupan input. Bisa NULL. Jika bukan NULL, semua cakupan input dalam array diatur sebagai cakupan input jendela dengan bobot yang sama. Gunakan IS_DEFAULT untuk menerima semua cakupan input lainnya juga.

[in] cInputScopes

Jumlah cakupan input dalam array yang diacu oleh *pInputScopes. Nilai ini harus nol jika array adalah NULL.

[in] ppszPhraseList

Penunjuk ke array pointer ke frasa yang dihentikan NULL. Bisa NULL.

[in] cPhrases

Jumlah pointer yang ditunjukkan oleh **ppszPhraseList, yang menunjukkan jumlah frasa.

[in] pszRegExp

Penunjuk ke string yang dihentikan NULL yang berisi ekspresi reguler yang akan dikenali. Bisa 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	Metode berhasil.

Keterangan

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

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 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