CWnd::EnableWindow

Article
03/04/2013

Active ou désactive l'entrée de souris et de clavier.

BOOL EnableWindow(
   BOOL bEnable = TRUE 
);

Paramètres

bEnable
Spécifie si la fenêtre donnée doit être activée ou désactivée.Si ce paramètre est TRUE, la fenêtre est activée.Si ce paramètre est FALSE, la fenêtre est désactivée.

Valeur de retour

Indique l'état avant que la fonction membre d' EnableWindow a été appelée.La valeur de retour est différente de zéro si la fenêtre était précédemment désactivée.La valeur de retour est 0 si la fenêtre était précédemment activée ou une erreur se produit.

Notes

Lorsque l'entrée est désactivée, l'entrée telle que les clics de souris et des séquences de touches est ignorée.Lorsque l'entrée est activée, la fenêtre traite toutes les entrées.

Si l'état activé change, le message de WM_ENABLE est envoyé pour que cette fonction retourne.

Si désactivées, toutes les fenêtres enfants sont implicitement désactivées, bien qu'ils ne soient pas les messages envoyés d' 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 non modale et désactivé sa fenêtre principale, la fenêtre principale doit être activée avant la boîte de dialogue soit perdue.Sinon, une autre fenêtre obtient le focus d'entrée et est activée.Si une fenêtre enfant est désactivée, elle est ignorée lorsque les tests windows pour déterminer la fenêtre doit recevoir des messages de la souris.

Par défaut, une fenêtre est activée lorsqu'elle est créée.Une application peut spécifier le style de WS_DISABLED dans la fonction membre de Create ou de CreateEx pour créer une fenêtre qui est initialement désactivée.Une fois qu'une fenêtre créée, une application peut également utiliser la fonction membre d' 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 de désactivé ne peut pas recevoir le focus d'entrée, ni est un accès utilisateur -le.

Exemple

//CMyFileDialog is a CFileDialog-derived class
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog() 
{
   CFileDialog::OnInitDialog();

   CWnd* pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3'

   //disables the 'file name' edit and static control
   //of the standard file open dialog

   //get handle of 'file name' combobox control & disable it
   CWnd* pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}