Freigeben über


BringWindowToTop-Funktion (winuser.h)

Bringt das angegebene Fenster an den Anfang der Z-Reihenfolge. Wenn es sich bei dem Fenster um ein Fenster auf oberster Ebene handelt, wird es aktiviert. Wenn es sich bei dem Fenster um ein untergeordnetes Fenster handelt, wird das übergeordnete Fenster der obersten Ebene aktiviert, das dem untergeordneten Fenster zugeordnet ist.

Syntax

BOOL BringWindowToTop(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Ziehpunkt zum Fenster, um die Z-Reihenfolge an den Anfang zu bringen.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Verwenden Sie die BringWindowToTop-Funktion , um jedes Fenster aufzudecken, das von anderen Fenstern teilweise oder vollständig verdeckt wird.

Das Aufrufen dieser Funktion ähnelt dem Aufrufen der SetWindowPos-Funktion , um die Position eines Fensters in der Z-Reihenfolge zu ändern. BringWindowToTop macht ein Fenster nicht zu einem Fenster auf oberster Ebene.

Anforderungen

Anforderung Wert
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-0 (eingeführt in Windows 8)

Siehe auch

Konzept

Referenz

SetWindowPos

Windows