Fonction ActivateKeyboardLayout (winuser.h)
Définit l’identificateur de paramètres régionaux d’entrée (anciennement appelé handle de disposition du clavier) pour le thread appelant ou le processus en cours. L’identificateur de paramètres régionaux d’entrée spécifie des paramètres régionaux ainsi que la disposition physique du clavier.
Syntaxe
HKL ActivateKeyboardLayout(
[in] HKL hkl,
[in] UINT Flags
);
Paramètres
[in] hkl
Type : HKL
Identificateur de paramètres régionaux d’entrée à activer.
L’identificateur de paramètres régionaux d’entrée doit avoir été chargé par un appel précédent à la fonction LoadKeyboardLayout . Ce paramètre doit être le handle d’une disposition de clavier ou l’une des valeurs suivantes.
[in] Flags
Type : UINT
Spécifie la façon dont l’identificateur de paramètres régionaux d’entrée doit être activé. Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Si ce bit est défini, la liste circulaire du système des identificateurs de paramètres régionaux chargés est réorganisé en déplaçant l’identificateur de paramètres régionaux vers le début de la liste. Si ce bit n’est pas défini, la liste est pivotée sans changement d’ordre.
Par exemple, si un utilisateur avait un identificateur de paramètres régionaux anglais actif, ainsi que des identificateurs de paramètres régionaux Français, allemands et espagnols chargés (dans cet ordre), l’activation de l’identificateur de paramètres régionaux allemands avec l’ensemble de bits KLF_REORDER produirait l’ordre suivant : allemand, anglais, Français, espagnol. L’activation de l’identificateur de paramètres régionaux allemands sans le jeu de bits KLF_REORDER produirait l’ordre suivant : allemand, espagnol, anglais, Français. Si moins de trois identificateurs régionaux sont chargés, la valeur de cet indicateur n’est pas pertinente. |
|
Si la valeur est définie, mais qu’KLF_SHIFTLOCK n’est pas définie, l’état Verr. majuscules est désactivé en appuyant à nouveau sur la touche Verr. Verr. Si la valeur est définie et KLF_SHIFTLOCK est également définie, l’état de verrouillage des majuscules est désactivé en appuyant sur l’une ou l’autre touche MAJ.
Ces deux méthodes s’excluent mutuellement et le paramètre persiste dans le profil de l’utilisateur dans le Registre. |
|
Active l’identificateur de paramètres régionaux spécifié pour l’ensemble du processus et envoie le message WM_INPUTLANGCHANGE au focus ou à la fenêtre active du thread actif. |
|
Il est utilisé avec KLF_RESET. Pour obtenir une explication , consultez KLF_RESET . |
|
Cet indicateur n’est pas pris en charge. Utilisez la fonction UnloadKeyboardLayout à la place. |
Valeur retournée
Type : HKL
La valeur de retour est de type HKL. Si la fonction réussit, la valeur de retour est l’identificateur de paramètres régionaux d’entrée précédent. Sinon, c’est zéro.
Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .
Remarques
Cette fonction affecte uniquement la disposition du processus ou du thread en cours.
Cette fonction n’est pas limitée aux dispositions du clavier. Le paramètre hkl est en fait un identificateur de paramètres régionaux d’entrée. Il s’agit d’un concept plus large qu’une disposition de clavier, car elle peut également englober un convertisseur de reconnaissance vocale, un éditeur de méthode d’entrée (IME) ou toute autre forme d’entrée. Plusieurs identificateurs de paramètres régionaux d’entrée peuvent être chargés à tout moment, mais un seul est actif à la fois. Le chargement de plusieurs identificateurs de paramètres régionaux d’entrée permet de basculer rapidement entre eux.
Lorsque plusieurs IME sont autorisés pour chaque paramètre régional, le passage d’un identificateur de paramètres régionaux d’entrée dans lequel le mot haut (le handle d’appareil) est zéro active le premier IME de la liste appartenant aux paramètres régionaux.
Les indicateurs de KLF_RESET et de KLF_SHIFTLOCK modifient la méthode par laquelle l’état verr les majuscules est désactivé. Par défaut, l’état Verr. maj est désactivé en appuyant à nouveau sur la touche Verr. Verr. Si seul KLF_RESET est défini, l’état par défaut est rétabli. Si KLF_RESET et KLF_SHIFTLOCK sont définis, l’état Verr. majuscules est désactivé en appuyant sur l’une ou l’autre des touches Verr. Cette fonctionnalité est utilisée pour se conformer aux normes de comportement du clavier local ainsi qu’aux préférences personnelles.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
Conceptuel
Référence