EnableWindow-Funktion (winuser.h)

Artikel
08/27/2023

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)