BeginDeferWindowPos-Funktion (winuser.h)

Artikel
03/04/2024

Weist Arbeitsspeicher für eine Struktur mit mehreren Fenstern zu und gibt den Handle an die Struktur zurück.

Syntax

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Parameter

[in] nNumWindows

Typ: int

Die anfängliche Anzahl von Fenstern, für die Positionsinformationen gespeichert werden sollen. Die DeferWindowPos-Funktion erhöht bei Bedarf die Größe der Struktur.

Rückgabewert

Typ: HDWP

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert die Struktur mit mehreren Fenstern. Wenn nicht genügend Systemressourcen für die Zuordnung der Struktur verfügbar sind, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Struktur mit mehreren Fenstern ist eine interne Struktur. eine Anwendung kann nicht direkt darauf zugreifen.

DeferWindowPos füllt die Struktur mit mehreren Fenstern mit Informationen zur Zielposition für ein oder mehrere Fenster, die verschoben werden sollen. Die EndDeferWindowPos-Funktion akzeptiert das Handle für diese Struktur und positioniert die Fenster mithilfe der in der Struktur gespeicherten Informationen neu.

Wenn das System die Größe der Struktur mit mehreren Fenstern über die durch den nNumWindows-Parameter angegebene Anfangsgröße hinaus erhöhen muss, dafür aber nicht genügend Arbeitsspeicher zuweisen kann, schlägt das System die gesamte Fensterpositionierungssequenz (BeginDeferWindowPos, DeferWindowPos und EndDeferWindowPos) fehl. Durch Angabe der maximal erforderlichen Größe kann eine Anwendung Fehler frühzeitig erkennen und verarbeiten.

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-4 (eingeführt in Windows 10, Version 10.0.14393)