Fonction ActivateKeyboardLayout (winuser.h)

Article
08/27/2023

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.

Valeur	Signification
HKL_NEXT 1	Sélectionne l’identificateur de paramètres régionaux suivant dans la liste circulaire des identificateurs de paramètres régionaux chargés gérés par le système.
HKL_PREV 0	Sélectionne l’identificateur de paramètres régionaux précédent dans la liste circulaire des identificateurs de paramètres régionaux chargés gérés par le système.

[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
KLF_REORDER 0x00000008	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.
KLF_RESET 0x40000000	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.
KLF_SETFORPROCESS 0x00000100	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.
KLF_SHIFTLOCK 0x00010000	Il est utilisé avec KLF_RESET. Pour obtenir une explication , consultez KLF_RESET .
KLF_UNLOADPREVIOUS	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