Funzione SetWindowPlacement (winuser.h)

Imposta lo stato di visualizzazione e le posizioni ripristinate, ridotte a icona e ingrandita della finestra specificata.

Sintassi

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra.

[in] lpwndpl

Tipo: const WINDOWPLACEMENT*

Puntatore a una struttura WINDOWPLACEMENT che specifica le nuove posizioni dello stato e della finestra.

Prima di chiamare SetWindowPlacement, impostare il membro length della struttura WINDOWPLACEMENT su sizeof(WINDOWPLACEMENT). SetWindowPlacement ha esito negativo se il membro di lunghezza non è impostato correttamente.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se le informazioni specificate in WINDOWPLACEMENT generano una finestra completamente fuori dallo schermo, il sistema regola automaticamente le coordinate in modo che la finestra sia visibile, tenendo conto delle modifiche apportate alla risoluzione dello schermo e alla configurazione di più monitor.

Il membro length di WINDOWPLACEMENT deve essere impostato su sizeof(WINDOWPLACEMENT). Se questo membro non è impostato correttamente, la funzione restituisce FALSE. Per ulteriori osservazioni sull'uso corretto delle coordinate di posizionamento della finestra, vedere WINDOWPLACEMENT.

Requisiti

   
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-3 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

Informazioni concettuali

GetWindowPlacement

Riferimento

WINDOWPLACEMENT

Windows