Freigeben über

IsWindowArranged-Funktion (winuser.h)

  • Artikel

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

Weitere Informationen