Fonction EnableWindow (winuser.h)

Article
08/27/2023

Active ou désactive l'entrée de la souris et du clavier dans la fenêtre ou le contrôle spécifié. Lorsque l’entrée est désactivée, la fenêtre ne reçoit pas de données telles que les clics de souris et les pressions sur les touches. Lorsque l’entrée est activée, la fenêtre reçoit toutes les entrées.

Syntaxe

BOOL EnableWindow(
  [in] HWND hWnd,
  [in] BOOL bEnable
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre à activer ou à désactiver.

[in] bEnable

Type : BOOL

Indique s’il faut activer ou désactiver la fenêtre. Si ce paramètre a la valeur TRUE, la fenêtre est activée. Si le paramètre est FALSE, la fenêtre est désactivée.

Valeur retournée

Type : BOOL

Si la fenêtre a été précédemment désactivée, la valeur de retour est différente de zéro.

Si la fenêtre n’a pas été désactivée précédemment, la valeur de retour est zéro.

Remarques

Si la fenêtre est désactivée, le système envoie un message WM_CANCELMODE . Si l’état activé d’une fenêtre change, le système envoie un message WM_ENABLE après le message WM_CANCELMODE . (Ces messages sont envoyés avant le retour d’EnableWindow .) Si une fenêtre est déjà désactivée, ses fenêtres enfants sont implicitement désactivées, bien qu’elles ne reçoivent pas de message WM_ENABLE .

Une fenêtre doit être activée avant de pouvoir être activée. Par exemple, si une application affiche une boîte de dialogue sans mode et a désactivé sa fenêtre de main, l’application doit activer la fenêtre main avant de détruire la boîte de dialogue. Sinon, une autre fenêtre reçoit le focus du clavier et est activée. Si une fenêtre enfant est désactivée, elle est ignorée lorsque le système tente de déterminer quelle fenêtre doit recevoir des messages de souris.

Par défaut, une fenêtre est activée lors de sa création. Pour créer une fenêtre qui est initialement désactivée, une application peut spécifier le style WS_DISABLED dans la fonction CreateWindow ou CreateWindowEx . Une fois qu’une fenêtre a été créée, une application peut utiliser EnableWindow pour activer ou désactiver la fenêtre.

Une application peut utiliser cette fonction pour activer ou désactiver un contrôle dans une boîte de dialogue. Un contrôle désactivé ne peut pas recevoir le focus clavier, et un utilisateur ne peut pas y accéder.

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
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)