EnableWindow-Funktion (winuser.h)
Aktiviert oder deaktiviert die Maus- und Tastatureingabe in das angegebene Fenster oder Steuerelement. Wenn die Eingabe deaktiviert ist, empfängt das Fenster keine Eingaben per Mausklick oder Tastendruck. Wenn die Eingabe aktiviert ist, empfängt das Fenster alle Eingaben.
Syntax
BOOL EnableWindow(
[in] HWND hWnd,
[in] BOOL bEnable
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das zu aktivierende oder deaktivierte Fenster.
[in] bEnable
Typ: BOOL
Gibt an, ob das Fenster aktiviert oder deaktiviert werden soll. Wenn dieser Parameter TRUE ist, ist das Fenster aktiviert. Wenn der Parameter FALSE ist, ist das Fenster deaktiviert.
Rückgabewert
Typ: BOOL
Wenn das Fenster zuvor deaktiviert war, ist der Rückgabewert nonzero.
Wenn das Fenster zuvor nicht deaktiviert wurde, ist der Rückgabewert 0.
Hinweise
Wenn das Fenster deaktiviert ist, sendet das System eine WM_CANCELMODE Nachricht. Wenn sich der aktivierte Status eines Fensters ändert, sendet das System nach der WM_CANCELMODE Nachricht eine WM_ENABLE Nachricht. (Diese Nachrichten werden gesendet, bevor EnableWindow zurückgibt.) Wenn ein Fenster bereits deaktiviert ist, werden die untergeordneten Fenster implizit deaktiviert, obwohl ihnen keine WM_ENABLE Nachricht gesendet wird.
Ein Fenster muss aktiviert werden, bevor es aktiviert werden kann. Wenn eine Anwendung beispielsweise ein dialogfeld ohne Modus anzeigt und ihr Standard Fenster deaktiviert hat, muss die Anwendung das Standard Fenster aktivieren, bevor das Dialogfeld zerstört wird. Andernfalls erhält ein anderes Fenster den Tastaturfokus und wird aktiviert. Wenn ein untergeordnetes Fenster deaktiviert ist, wird es ignoriert, wenn das System versucht, zu bestimmen, welches Fenster Mausnachrichten empfangen soll.
Standardmäßig ist ein Fenster aktiviert, wenn es erstellt wird. Um ein Fenster zu erstellen, das zunächst deaktiviert ist, kann eine Anwendung den WS_DISABLED Stil in der Funktion CreateWindow oder CreateWindowEx angeben. Nachdem ein Fenster erstellt wurde, kann eine Anwendung EnableWindow 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 deaktiviertes Steuerelement kann weder den Tastaturfokus empfangen noch ein Benutzer darauf zugreifen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393) |
Siehe auch
Konzept
Referenz