Freigeben über


SetActiveWindow-Funktion (winuser.h)

Aktiviert ein Fenster. Das Fenster muss an die Meldungswarteschlange des aufrufenden Threads angefügt werden.

Syntax

HWND SetActiveWindow(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das fenster der obersten Ebene, das aktiviert werden soll.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für das zuvor aktive Fenster.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die SetActiveWindow-Funktion aktiviert ein Fenster, aber nicht, wenn sich die Anwendung im Hintergrund befindet. Das Fenster wird in den Vordergrund (oben in Z-Order) gebracht, wenn sich seine Anwendung im Vordergrund befindet, wenn das System das Fenster aktiviert.

Wenn das durch den hWnd-Parameter identifizierte Fenster vom aufrufenden Thread erstellt wurde, wird das aktive Fenster status des aufrufenden Threads auf hWnd festgelegt. Andernfalls wird das aktive Fenster status des aufrufenden Threads auf NULL festgelegt.

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 (windows.h einschließen)
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

GetActiveWindow

Tastatureingabe

Referenz

SetForegroundWindow

WM_ACTIVATE