DeferWindowPos-Funktion (winuser.h)

Aktualisiert die angegebene Mehrfensterpositionsstruktur für das angegebene Fenster. Die Funktion gibt dann ein Handle an die aktualisierte Struktur zurück. Die Funktion EndDeferWindowPos verwendet die Informationen in dieser Struktur, um die Position und Größe einer Reihe von Fenstern gleichzeitig zu ändern. Die BeginDeferWindowPos-Funktion erstellt die Struktur.

Syntax

HDWP DeferWindowPos(
  [in]           HDWP hWinPosInfo,
  [in]           HWND hWnd,
  [in, optional] HWND hWndInsertAfter,
  [in]           int  x,
  [in]           int  y,
  [in]           int  cx,
  [in]           int  cy,
  [in]           UINT uFlags
);

Die Parameter

[in] hWinPosInfo

Typ: HDWP

Ein Handle für ein Mehrfachfenster – Positionsstruktur, die Größen- und Positionsinformationen für ein oder mehrere Fenster enthält. Diese Struktur wird von BeginDeferWindowPos oder vom letzten Aufruf von DeferWindowPos zurückgegeben.

[in] hWnd

Typ: HWND-

Ein Handle für das Fenster, für das Aktualisierungsinformationen in der Struktur gespeichert werden. Alle Fenster in einem Mehrfenster – Positionsstruktur müssen dasselbe übergeordnete Element aufweisen.

[in, optional] hWndInsertAfter

Typ: HWND-

Ein Handle für das Fenster, das dem positionierten Fenster in der Z-Reihenfolge vorausgeht. Dieser Parameter muss ein Fensterhandle oder eins der folgenden Werte sein. Dieser Parameter wird ignoriert, wenn das flag SWP_NOZORDER im uFlags-Parameter festgelegt ist.

[in] x

Typ: int

Die x-Koordinate der oberen linken Ecke des Fensters.

[in] y

Typ: int

Die Y-Koordinate der oberen linken Ecke des Fensters.

[in] cx

Typ: int

Die neue Breite des Fensters in Pixel.

[in] cy

Typ: int

Die neue Höhe des Fensters in Pixel.

[in] uFlags

Typ: UINT

Eine Kombination der folgenden Werte, die sich auf die Größe und Position des Fensters auswirken.

Rückgabewert

Typ: HDWP

Der Rückgabewert identifiziert die aktualisierte Mehrfensterpositionsstruktur. Der von dieser Funktion zurückgegebene Handle kann sich von dem handle unterscheiden, der an die Funktion übergeben wird. Das neue Handle, das diese Funktion zurückgibt, sollte während des nächsten Aufrufs der Funktion DeferWindowPos oder EndDeferWindowPos übergeben werden.

Wenn nicht genügend Systemressourcen verfügbar sind, damit die Funktion erfolgreich ausgeführt werden kann, ist der Rückgabewert NULL. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Wenn ein Aufruf von DeferWindowPos fehlschlägt, sollte die Anwendung den Fensterpositionierungsvorgang abbrechen und nicht EndDeferWindowPos aufrufen.

Wenn SWP_NOZORDER nicht angegeben ist, platziert das System das durch den hWnd-Parameter identifizierte Fenster an der Position nach dem durch den hWndInsertAfter-Parameter identifizierten Fenster. Wenn hWndInsertAfterNULL oder HWND_TOP ist, platziert das System das hWnd-Fenster oben in der Z-Reihenfolge. Wenn hWndInsertAfter auf HWND_BOTTOM festgelegt ist, platziert das System das hWnd-Fenster am unteren Rand der Z-Reihenfolge.

Alle Koordinaten für untergeordnete Fenster sind relativ zur oberen linken Ecke des Clientbereichs des übergeordneten Fensters.

Ein Fenster kann entweder durch Festlegen von hWndInsertAfter auf das HWND_TOPMOST Flag und sicherstellen, dass das SWP_NOZORDER Flag nicht festgelegt ist, oder indem die Position des Fensters in der Z-Reihenfolge festgelegt wird, sodass es über allen vorhandenen obersten Fenstern liegt. Wenn ein nicht oberstes Fenster ganz oben erstellt wird, werden auch die eigenen Fenster ganz oben erstellt. Seine Besitzer werden jedoch nicht geändert.

Wenn weder das SWP_NOACTIVATE noch SWP_NOZORDER Flag angegeben wird (d. h., wenn die Anwendung anfordert, dass ein Fenster gleichzeitig aktiviert und seine Position in der Z-Reihenfolge geändert wird), wird der in hWndInsertAfter angegebene Wert nur unter folgenden Umständen verwendet:

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

Ein oberstes Fenster befindet sich nicht mehr ganz oben, wenn es nach unten (HWND_BOTTOM) der Z-Reihenfolge oder nach einem nicht obersten Fenster neu positioniert wird. Wenn ein oberstes Fenster nicht ganz oben erstellt wird, werden die Besitzer und die eigenen Fenster ebenfalls nicht oberste Fenster erstellt.

Ein nicht oberstes Fenster besitzt möglicherweise ein oberstes Fenster, aber nicht umgekehrt. Jedes Fenster (z. B. ein Dialogfeld) im Besitz eines obersten Fensters ist selbst ein oberstes Fenster, um sicherzustellen, dass alle eigenen Fenster über ihrem Besitzer bleiben.

Anforderungen

Siehe auch

BeginDeferWindowPos

Konzeptionelle

EndDeferWindowPos

Referenz

ShowWindow

Windows