Fonction SetInputScopes (inputscope.h)

Article
08/24/2023

Définit une combinaison d’une étendue d’entrée, de plusieurs étendues d’entrée, d’une liste d’expressions, d’une expression régulière et/ou de règles SRGS (Speech Recognition Grammar Specification) pour la fenêtre spécifiée.

Syntaxe

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

Paramètres

[in] hwnd

Fenêtre sur laquelle définir l’étendue.

[in] pInputScopes

Pointeur vers un tableau d’étendues d’entrée. Peut être NULL. Si ce n’est pas NULL, toutes les étendues d’entrée du tableau sont définies comme étendue d’entrée de la fenêtre avec une pondération égale. Utilisez IS_DEFAULT pour accepter toutes les autres étendues d’entrée.

[in] cInputScopes

Nombre d’étendues d’entrée dans le tableau pointé vers *pInputScopes. Cette valeur doit être égale à zéro si le tableau a la valeur NULL.

[in] ppszPhraseList

Pointeur vers un tableau de pointeurs vers des expressions terminées par NULL. Peut être NULL.

[in] cPhrases

Nombre de pointeurs pointés vers **ppszPhraseList, qui représente le nombre d’expressions.

[in] pszRegExp

Pointeur vers une chaîne terminée par NULL contenant l’expression régulière à reconnaître. Peut être NULL.

[in] pszSRGS

Pointeur vers une chaîne XML terminée par NULL qui fournit des indicateurs et des règles spécifiques à la parole pour faciliter la reconnaissance vocale. Le format XML est conforme à la norme SRGS (Speech Recognition Grammar Specification), décrite à l’adresse http://www.w3.org/TR/speech-grammar. Peut être NULL. $

Valeur retournée

Valeur	Signification
S_OK	La méthode a réussi.

Notes

L’appel de cette méthode remplace l’étendue associée à la fenêtre.

Cette API fonctionne uniquement lorsque la fenêtre (paramètre hwnd) et le thread appelant se trouvent dans le même thread. Si vous appelez cette API pour une autre fenêtre de thread, elle échoue avec E_INVALIDARG.

Si vous appelez cette méthode sur une fenêtre (paramètre hwnd ) qui n’a pas été associée à un Gestionnaire de documents, aucune notification de service de texte n’est envoyée aux clients intéressés (par exemple, le clavier tactile) qui souhaitent répondre au changement d’étendue.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	inputscope.h
DLL	Msctf.dll

Partager via