EnableWindow-Funktion (winuser.h)

Artikel
09/27/2022

Aktiviert oder deaktiviert Maus- und Tastatureingaben für das angegebene Fenster oder Steuerelement. Wenn die Eingabe deaktiviert ist, empfängt das Fenster keine Eingaben, z. B. Mausklicks und Tasten drücken. 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 Fenster, das aktiviert oder deaktiviert werden soll.

[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 FALSCH ist, ist das Fenster deaktiviert.

Rückgabewert

Typ: BOOL

Wenn das Fenster zuvor deaktiviert wurde, ist der Rückgabewert nicht zero.

Wenn das Fenster noch nicht deaktiviert wurde, ist der Rückgabewert null.

Bemerkungen

Wenn das Fenster deaktiviert ist, sendet das System eine WM_CANCELMODE Nachricht. Wenn sich der aktivierte Status eines Fensters ändert, sendet das System eine WM_ENABLE Nachricht nach der WM_CANCELMODE Nachricht. (Diese Nachrichten werden gesendet, bevor EnableWindow zurückgegeben wird.) Wenn ein Fenster bereits deaktiviert ist, werden die untergeordneten Fenster implizit deaktiviert, obwohl sie keine WM_ENABLE Nachricht gesendet werden.

Ein Fenster muss aktiviert werden, bevor es aktiviert werden kann. Wenn beispielsweise eine Anwendung ein modusloses Dialogfeld anzeigt und das Hauptfenster deaktiviert hat, muss die Anwendung das Hauptfenster 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. Zum Erstellen eines anfangs deaktivierten Fensters kann eine Anwendung die WS_DISABLED Formatvorlage 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 den Tastaturfokus nicht empfangen, oder ein Benutzer erhält zugriff darauf.

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 (enthalten 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)