IsWindowArranged-Funktion (winuser.h)
Wichtig
Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe wesentlich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bestimmt, ob ein Fenster angeordnet ist.
Syntax
BOOL IsWindowArranged(
HWND hwnd
);
Parameter
hwnd
Typ: HWND
Ein Handle für das zu testende Fenster.
Rückgabewert
Typ: BOOL
Ein Wert ungleich Null, wenn das Fenster angeordnet ist; andernfalls 0.
Bemerkungen
Tipp
Zu diesem Zeitpunkt verfügt diese Funktion nicht über eine zugeordnete Header- oder Bibliotheksdatei. Ihre Anwendung kann LoadLibrary mit dem DLL-Namen (User32.dll) aufrufen, um ein Modulhandle abzurufen. Anschließend kann getProcAddress mit dem Modulhandle und dem Namen dieser Funktion aufgerufen werden, um die Funktionsadresse abzurufen.
Ein angedocktes Fenster (siehe Ausrichten von Fenstern) gilt als angeordnet. Sie sollten den angeordneten Fensterzustand ähnlich wie maximiert behandeln. Angeordnete, maximierte und minimierte Zustände schließen sich gegenseitig aus. Ein angeordnetes Fenster kann auf seine ursprüngliche Größe und Position wiederhergestellt werden. Durch das Wiederherstellen eines Fensters von minimiert kann ein Fenster angeordnet werden, das angeordnet wurde, bevor es minimiert wurde. Beachten Sie beim Aufrufen von GetWindowPlacement, dass das showCmd-Element im zurückgegebenen WINDOWPLACEMENT den Wert SW_SHOWNORMAL haben kann, auch wenn das Fenster angeordnet ist.
Beispiel
// Check whether the window is in the restored state.
BOOL IsRestored(HWND hwnd)
{
if (IsIconic(hwnd) || IsZoomed(hwnd) || IsWindowArranged(hwnd))
{
return false;
}
return true;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1903 |
| Kopfzeile | winuser.h |
| Bibliothek | User32.lib |
| DLL | User32.dll |