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
Referenz