Fonction SetInputScopes2 (inputscope.h)

L’application doit appeler SetInputScope avec IS_DEFAULT avant qu’une fenêtre ne soit détruite pour effacer la référence de l’interface.

Syntaxe

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

Paramètres

[in] hwnd

Fenêtre sur laquelle définir l’étendue. Cet appel remplacera n’importe quelle étendue qui aurait pu se trouver sur le hwnd auparavant.

[in] pInputScopes

Pointeur vers un tableau d’étendues d’entrée. Peut être NULL. Si ce n’est pas NULL, toutes les étendues contenues dans seront définies comme étendue d’entrée du hwnd avec une pondération égale. Utilisez IS_DEFAULT pour accepter également toutes les autres entrées (il s’agit de l’option « ne pas forcer »).

[in] cInputScopes

Nombre d’étendues d’entrée dans pInputScopes. Doit être égal à zéro si rgScopes a la valeur NULL, et doit être différent de zéro si pInputScopes n’est pas NULL.

[in] pEnumString

Pointeur d’interface IenumString de la liste d’expressions.

[in] pszRegExp

Pointeur vers une chaîne terminée par NULL décrivant 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

Notes

L’application doit appeler SetInputScope avec IS_DEFAULT avant qu’une fenêtre ne soit détruite pour effacer la référence de l’interface.

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