CWnd::EnableWindow

Artikel
02/26/2013

Aktiviert oder deaktiviert Maus- und Tastatureingaben.

BOOL EnableWindow(
   BOOL bEnable = TRUE 
);

Parameter

bEnable
Gibt an, ob das angegebene Fenster aktiviert oder deaktiviert werden soll.Wenn dieser Parameter TRUE ist, wird das Fenster aktiviert.Wenn dieser Parameter FALSE ist, wird das Fenster deaktiviert.

Rückgabewert

Gibt den Zustand an, bevor die EnableWindow-Memberfunktion aufgerufen wurde.Der Rückgabewert ist ungleich 0 (null), wenn das Fenster zuvor deaktiviert wurde.Der Rückgabewert ist 0, wenn das Fenster zuvor aktiviert wurde, oder ein Fehler aufgetreten ist.

Hinweise

Wenn Eingabe deaktiviert wird, wird Eingabe wie Mausklicks und Tastatureingaben ignoriert.Wenn Eingabe aktiviert ist, verarbeitet das Fenster alle Eingaben.

Wenn der aktivierten Zustand ändert, wird die WM_ENABLE Meldung gesendet, bevor diese Funktion zurückgibt.

Wenn das Kontrollkästchen deaktiviert ist, werden alle untergeordneten Fenster implizit deaktiviert, obwohl sie nicht gesendete WM_ENABLE Meldungen sind.

Ein Fenster muss aktiviert werden, bevor es aktiviert werden kann.Wenn eine Anwendung ein nicht modales Dialogfeld anzeigt und das Hauptfenster deaktiviert hat, muss das Hauptfenster aktiviert werden, bevor das Dialogfeld zerstört wird.Andernfalls wird ein anderes Fenster ist den Eingabefokus ab und aktiviert.Wenn ein untergeordnetes Fenster deaktiviert wird, wird es ignoriert, wenn Windows versucht, festzustellen, welches Fenster Mausmeldungen erhalten soll.

Standardmäßig wird ein Fenster aktiviert, wenn es erstellt wird.Eine Anwendung kann das WS_DISABLED Format in der Erstellen Sie oder CreateEx-Memberfunktion angeben, um ein Fenster erstellen, das zuerst deaktiviert ist.Nachdem ein Fenster erstellt wurde, kann eine Anwendung die EnableWindow-Memberfunktion auch verwenden, um das Fenster zu aktivieren oder zu deaktivieren.

Eine Anwendung kann diese Funktion verwenden, um ein Steuerelement in einem Dialogfeld zu aktivieren oder zu deaktivieren.Ein Behinderter steuern kann den Eingabefokus nicht erhalten, noch kann ein Benutzerzugriff es.

Beispiel

//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;
}