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