Fonction EnableWindow (winuser.h)
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) |
Voir aussi
Conceptuel
Référence