WINDOWPLACEMENT-Struktur (winuser.h)

Artikel
03/15/2023

Enthält Informationen zur Platzierung eines Fensters auf dem Bildschirm.

Syntax

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

Member

length

Typ: UINT

Die Länge der Struktur in Bytes. Legen Sie vor dem Aufrufen der Funktionen GetWindowPlacement oder SetWindowPlacement dieses Element auf fest sizeof(WINDOWPLACEMENT).

GetWindowPlacement und SetWindowPlacement schlagen fehl, wenn dieser Member nicht ordnungsgemäß festgelegt ist.

flags

Typ: UINT

Die Flags, die die Position des minimierten Fensters steuern, und die Methode, mit der das Fenster wiederhergestellt wird. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
WPF_ASYNCWINDOWPLACEMENT 0x0004	Wenn der aufrufende Thread und der Thread, der das Fenster besitzt, an verschiedene Eingabewarteschlangen angefügt sind, sendet das System die Anforderung an den Thread, der das Fenster besitzt. Dadurch wird verhindert, dass der aufrufende Thread die Ausführung blockiert, während andere Threads die Anforderung verarbeiten.
WPF_RESTORETOMAXIMIZED 0x0002	Das wiederhergestellte Fenster wird maximiert, unabhängig davon, ob es maximiert wurde, bevor es minimiert wurde. Diese Einstellung ist nur gültig, wenn das Fenster das nächste Mal wiederhergestellt wird. Das Standardwiederherstellungsverhalten wird nicht geändert. Dieses Flag ist nur gültig, wenn der SW_SHOWMINIMIZED-Wert für das showCmd-Element angegeben wird.
WPF_SETMINPOSITION 0x0001	Die Koordinaten des minimierten Fensters können angegeben werden. Dieses Flag muss angegeben werden, wenn die Koordinaten im ptMinPosition-Element festgelegt sind.

showCmd

Typ: UINT

Der aktuelle Anzeigestatus des Fensters. Dies kann jeder der Werte sein, die im Parameter nCmdShow für die Funktion ShowWindow angegeben werden können.

ptMinPosition

Typ: POINT

Die Koordinaten der oberen linken Ecke des Fensters, wenn das Fenster minimiert wird.

ptMaxPosition

Typ: POINT

Die Koordinaten der oberen linken Ecke des Fensters, wenn das Fenster maximiert ist.

rcNormalPosition

Typ: RECT

Die Koordinaten des Fensters, wenn sich das Fenster an der wiederhergestellten Position befindet.

rcDevice

Hinweise

Wenn es sich bei dem Fenster um ein Fenster auf oberster Ebene handelt, das nicht über die WS_EX_TOOLWINDOW Fensterstil verfügt, befinden sich die Koordinaten, die durch die folgenden Member dargestellt werden, in Arbeitsbereichskoordinaten: ptMinPosition, ptMaxPosition und rcNormalPosition. Andernfalls befinden sich diese Member in Bildschirmkoordinaten.

Arbeitsbereichskoordinaten unterscheiden sich von Bildschirmkoordinaten darin, dass sie die Speicherorte und Größen von Anwendungssymbolleisten (einschließlich der Taskleiste) berücksichtigen. Die Arbeitsbereichskoordinate (0,0) ist die obere linke Ecke des Arbeitsbereichsbereichs, wobei der Bereich des Bildschirms nicht von Anwendungssymbolleisten verwendet wird.

Die in einer WINDOWPLACEMENT-Struktur verwendeten Koordinaten sollten nur von den Funktionen GetWindowPlacement und SetWindowPlacement verwendet werden. Das Übergeben von Arbeitsbereichskoordinaten an Funktionen, die Bildschirmkoordinaten erwarten (z. B. SetWindowPos), führt dazu, dass das Fenster an der falschen Stelle angezeigt wird. Wenn sich beispielsweise die Taskleiste oben auf dem Bildschirm befindet, wird das Speichern von Fensterkoordinaten mithilfe von GetWindowPlacement und deren Wiederherstellung mithilfe von SetWindowPos dazu führen, dass das Fenster auf dem Bildschirm "kriechend" angezeigt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	winuser.h (einschließlich Windows.h)