Funzione BeginDeferWindowPos (winuser.h)

Articolo
03/04/2024

Alloca la memoria per una struttura di posizione a più finestre e restituisce l'handle alla struttura.

Sintassi

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Parametri

[in] nNumWindows

Tipo: int

Numero iniziale di finestre per cui archiviare le informazioni sulla posizione. La funzione DeferWindowPos aumenta le dimensioni della struttura, se necessario.

Valore restituito

Tipo: HDWP

Se la funzione ha esito positivo, il valore restituito identifica la struttura di posizione a più finestre. Se le risorse di sistema insufficienti sono disponibili per allocare la struttura, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La struttura a più finestre è una struttura interna; un'applicazione non può accedervi direttamente.

DeferWindowPos riempie la struttura a più finestre con informazioni sulla posizione di destinazione per uno o più finestre da spostare. La funzione EndDeferWindowPos accetta l'handle in questa struttura e riposiziona le finestre usando le informazioni archiviate nella struttura.

Se il sistema deve aumentare le dimensioni della struttura di posizione a più finestre oltre le dimensioni iniziali specificate dal parametro nNumWindows, ma non è in grado di allocare memoria sufficiente a tale scopo, il sistema non riesce l'intera sequenza di posizionamento della finestra (BeginDeferWindowPos, DeferWindowPos e EndDeferWindowPos). Specificando le dimensioni massime necessarie, un'applicazione può rilevare e elaborare l'errore all'inizio del processo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-4 (introdotta in Windows 10, versione 10.0.14393)