SetWindowPos-Funktion (winuser.h)

Artikel
08/28/2023

Ändert die Größe, Position und Z-Reihenfolge eines untergeordneten Fensters, eines Popupfensters oder eines Fensters auf oberster Ebene. Diese Fenster werden entsprechend ihrer Darstellung auf dem Bildschirm sortiert. Das oberste Fenster erhält den höchsten Rang und ist das erste Fenster in der Z-Reihenfolge.

Syntax

BOOL SetWindowPos(
  [in]           HWND hWnd,
  [in, optional] HWND hWndInsertAfter,
  [in]           int  X,
  [in]           int  Y,
  [in]           int  cx,
  [in]           int  cy,
  [in]           UINT uFlags
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster.

[in, optional] hWndInsertAfter

Typ: HWND

Ein Handle für das Fenster, das dem positionierten Fenster in der Z-Reihenfolge vorangestellt wird. Dieser Parameter muss ein Fensterhandle oder einer der folgenden Werte sein.

Wert	Bedeutung
HWND_BOTTOM (HWND)1	Places das Fenster am unteren Rand der Z-Reihenfolge. Wenn der hWnd-Parameter ein oberstes Fenster identifiziert, verliert das Fenster seine oberste status und wird am unteren Rand aller anderen Fenster platziert.
HWND_NOTOPMOST (HWND)-2	Places das Fenster über allen nicht obersten Fenstern (d. a. hinter allen obersten Fenstern). Dieses Flag hat keine Auswirkung, wenn das Fenster bereits ein nicht oberstes Fenster ist.
HWND_TOP (HWND)0	Places das Fenster oben in der Z-Reihenfolge.
HWND_TOPMOST (HWND)-1	Places das Fenster über allen Fenstern, die nicht oberste Fenster sind. Das Fenster behält seine oberste Position bei, auch wenn es deaktiviert ist.

Weitere Informationen zur Verwendung dieses Parameters finden Sie im folgenden Abschnitt hinweise.

[in] X

Typ: int

Die neue Position der linken Seite des Fensters in Clientkoordinaten.

[in] Y

Typ: int

Die neue Position des oberen Rands des Fensters in Clientkoordinaten.

[in] cx

Typ: int

Die neue Breite des Fensters in Pixeln.

[in] cy

Typ: int

Die neue Höhe des Fensters in Pixeln.

[in] uFlags

Typ: UINT

Die Fensterdimensionierungs- und Positionierungsflags. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
SWP_ASYNCWINDOWPOS 0x4000	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 seine Ausführung blockiert, während andere Threads die Anforderung verarbeiten.
SWP_DEFERERASE 0x2000	Verhindert die Generierung der WM_SYNCPAINT Nachricht.
SWP_DRAWFRAME 0x0020	Zeichnet einen Rahmen (definiert in der Klassenbeschreibung des Fensters) um das Fenster.
SWP_FRAMECHANGED 0x0020	Wendet mithilfe der SetWindowLong-Funktion neue Frameformatvorlagen an. Sendet eine WM_NCCALCSIZE Nachricht an das Fenster, auch wenn die Größe des Fensters nicht geändert wird. Wenn dieses Flag nicht angegeben ist, wird WM_NCCALCSIZE nur gesendet, wenn die Größe des Fensters geändert wird.
SWP_HIDEWINDOW 0x0080	Blendet das Fenster aus.
SWP_NOACTIVATE 0x0010	Aktiviert das Fenster nicht. Wenn dieses Flag nicht festgelegt ist, wird das Fenster aktiviert und an den Anfang der obersten oder nicht obersten Gruppe verschoben (abhängig von der Einstellung des hWndInsertAfter-Parameters ).
SWP_NOCOPYBITS 0x0100	Verwirft den gesamten Inhalt des Clientbereichs. Wenn dieses Flag nicht angegeben ist, werden die gültigen Inhalte des Clientbereichs gespeichert und wieder in den Clientbereich kopiert, nachdem das Fenster dimensioniert oder neu positioniert wurde.
SWP_NOMOVE 0x0002	Behält die aktuelle Position bei (ignoriert die X - und Y-Parameter ).
SWP_NOOWNERZORDER 0x0200	Ändert die Position des Besitzerfensters in der Z-Reihenfolge nicht.
SWP_NOREDRAW 0x0008	Änderungen werden nicht neu gezeichnet. Wenn dieses Flag festgelegt ist, erfolgt keine Neulackierung jeglicher Art. Dies gilt für den Clientbereich, den Nichtclientbereich (einschließlich Titelleiste und Bildlaufleisten) und alle Teile des übergeordneten Fensters, die aufgrund des Verschiebens des Fensters aufgedeckt wurden. Wenn dieses Flag festgelegt ist, muss die Anwendung alle Teile des Fensters und des übergeordneten Fensters, die neu ausgezeichnet werden müssen, explizit für ungültig erklären oder neu zeichnen.
SWP_NOREPOSITION 0x0200	Identisch mit dem flag SWP_NOOWNERZORDER .
SWP_NOSENDCHANGING 0x0400	Verhindert, dass das Fenster die WM_WINDOWPOSCHANGING-Nachricht empfängt.
SWP_NOSIZE 0x0001	Behält die aktuelle Größe bei (ignoriert die Parameter cx und cy ).
SWP_NOZORDER 0x0004	Behält die aktuelle Z-Reihenfolge bei (ignoriert den Parameter hWndInsertAfter ).
SWP_SHOWWINDOW 0x0040	Zeigt das Fenster an.

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

Im Rahmen der Vista-Neuarchitektur wurden alle Dienste vom interaktiven Desktop in Sitzung 0 verschoben. hwnd- und Fenster-Manager-Vorgänge sind nur innerhalb einer Sitzung wirksam, und sitzungsübergreifende Versuche, den hwnd zu bearbeiten, schlagen fehl. Weitere Informationen finden Sie unter The Windows Vista Developer Story: Application Compatibility Cookbook.

Wenn Sie bestimmte Fensterdaten mithilfe von SetWindowLong geändert haben, müssen Sie SetWindowPos aufrufen, damit die Änderungen wirksam werden. Verwenden Sie die folgende Kombination für uFlags: SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED.

Ein Fenster kann zu einem obersten Fenster gemacht werden, indem entweder der hWndInsertAfter-Parameter auf HWND_TOPMOST festgelegt wird und sichergestellt wird, dass das SWP_NOZORDER-Flag nicht festgelegt ist, oder indem die Position eines Fensters in der Z-Reihenfolge festgelegt wird, sodass es über allen vorhandenen obersten Fenstern liegt. Wenn ein Fenster, das nicht ganz oben steht, an oberster Stelle steht, werden auch seine eigenen Fenster an oberster Stelle gestellt. Seine Besitzer werden jedoch nicht geändert.

Wenn weder das SWP_NOACTIVATE noch SWP_NOZORDER-Flag angegeben wird (d. h. wenn die Anwendung die gleichzeitige Aktivierung eines Fensters anfordert und seine Position in der Z-Reihenfolge geändert wird), wird der in hWndInsertAfter angegebene Wert nur unter den folgenden Umständen verwendet.

Weder das flag HWND_TOPMOST noch HWND_NOTOPMOST wird in hWndInsertAfter angegeben.
Das von hWnd identifizierte Fenster ist nicht das aktive Fenster.

Eine Anwendung kann ein inaktives Fenster nicht aktivieren, ohne es an den Anfang der Z-Reihenfolge zu bringen. Anwendungen können die Position eines aktivierten Fensters in der Z-Reihenfolge ohne Einschränkungen ändern, oder sie können ein Fenster aktivieren und es dann an die spitze der obersten oder nicht obersten Fenster verschieben.

Wenn ein Fenster am obersten Rand am unteren Rand (HWND_BOTTOM) der Z-Reihenfolge oder nach einem fenster, das nicht ganz oben liegt, neu positioniert wird, ist es nicht mehr ganz oben. Wenn ein oberstes Fenster als nicht oberstes Fenster festgelegt wird, werden seine Besitzer und seine eigenen Fenster ebenfalls zu nicht obersten Fenstern.

Ein Fenster, das nicht ganz oben steht, kann ein oberstes Fenster besitzen, aber die Umgekehrte kann nicht auftreten. Jedes Fenster (z. B. ein Dialogfeld), das einem obersten Fenster gehört, wird selbst zu einem obersten Fenster gemacht, um sicherzustellen, dass alle eigenen Fenster über ihrem Besitzer bleiben.

Wenn sich eine Anwendung nicht im Vordergrund befindet und sich im Vordergrund befinden sollte, muss sie die SetForegroundWindow-Funktion aufrufen.

Wenn Sie SetWindowPos verwenden möchten, um ein Fenster nach oben zu bringen, muss der Prozess, dem das Fenster gehört, über die Berechtigung SetForegroundWindow verfügen.

Beispiele

Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.

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)