Fonction SetInputScope (inputscope.h)

Définit une étendue d’entrée pour la fenêtre spécifiée.

Syntaxe

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Paramètres

[in] hwnd

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

[in] inputscope

Étendue d’entrée à associer à la fenêtre. Pour supprimer l’association d’étendue d’entrée, passez IS_DEFAULT à ce paramètre.

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.

Une application doit appeler cette méthode, en passant IS_DEFAULT au paramètre hwnd , pour supprimer l’association d’étendue d’entrée avant la destruction de 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 la fenêtre d’un autre 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 (comme le clavier tactile) qui peuvent vouloir répondre à la modification de l’étendue.

Exemples

[C++]

Le code suivant montre comment définir une étendue d’entrée pour une fenêtre.

SetInputScope(hwnd, IS_EMAIL_USERNAME);

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