Funzione SetInputScopes (inputscope.h)

Articolo
08/24/2023

Imposta una combinazione di un ambito di input, più ambiti di input, un elenco di frasi, un'espressione regolare e/o regole SRGS (Speech Recognition Grammar Specification) per la finestra specificata.

Sintassi

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

Parametri

[in] hwnd

Finestra su cui impostare l'ambito.

[in] pInputScopes

Puntatore a una matrice di ambiti di input. Può essere NULL. In caso contrario, tutti gli ambiti di input nella matrice vengono impostati come ambito di input della finestra con peso uguale. Usare IS_DEFAULT per accettare anche tutti gli altri ambiti di input.

[in] cInputScopes

Numero di ambiti di input nella matrice a cui punta *pInputScopes. Questo valore deve essere zero se la matrice è NULL.

[in] ppszPhraseList

Puntatore a una matrice di puntatori a frasi con terminazione NULL. Può essere NULL.

[in] cPhrases

Numero di puntatori puntati da **ppszPhraseList, che rappresenta il numero di frasi.

[in] pszRegExp

Puntatore a una stringa con terminazione NULL contenente l'espressione regolare da riconoscere. Può essere NULL.

[in] pszSRGS

Puntatore a una stringa XML con terminazione NULL che fornisce hint e regole specifici per il riconoscimento vocale. Il formato XML è conforme allo standard SRGS (Speech Recognition Grammar Specification), descritto in http://www.w3.org/TR/speech-grammar. Può essere NULL. $

Valore restituito

Valore	Significato
S_OK	Il metodo è stato eseguito correttamente.

Commenti

La chiamata a questo metodo sostituisce qualsiasi ambito sia associato alla finestra.

Questa API funziona solo quando la finestra (parametro hwnd) e il thread chiamante si trovano nello stesso thread. Se si chiama questa API per una finestra di thread diversa, non riesce con E_INVALIDARG.

Se si chiama questo metodo in una finestra (parametro hwnd ) che non è stato associato a un Document Manager, non vengono inviate notifiche di servizio di testo ai client interessati (ad esempio la tastiera virtuale) che potrebbero voler rispondere alla modifica dell'ambito.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	inputscope.h
DLL	Msctf.dll

Condividi tramite