Condividi tramite


Funzione GetWindowPlacement (winuser.h)

Recupera lo stato di visualizzazione e le posizioni ripristinate, ridotte al minimo e ingrandita della finestra specificata.

Sintassi

BOOL GetWindowPlacement(
  [in]      HWND            hWnd,
  [in, out] WINDOWPLACEMENT *lpwndpl
);

Parametri

[in] hWnd

Tipo: HWND

Handle nella finestra.

[in, out] lpwndpl

Tipo: WINDOWPLACEMENT*

Puntatore alla struttura WINDOWPLACEMENT che riceve le informazioni sullo stato e sulla posizione. Prima di chiamare GetWindowPlacement, impostare il membro di lunghezza su sizeof(WINDOWPLACEMENT). GetWindowPlacement ha esito negativo se lpwndpl-length> 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

Il membro flag di WINDOWPLACEMENT recuperato da questa funzione è sempre zero. Se la finestra identificata dal parametro hWnd è ingrandita, il membro showCmd è SW_SHOWMAXIMIZED. Se la finestra viene ridotta al minimo, showCmd è SW_SHOWMINIMIZED. In caso contrario, è SW_SHOWNORMAL.

Il membro di lunghezza di WINDOWPLACEMENT deve essere impostato su sizeof(WINDOWPLACEMENT). Se questo membro non è impostato correttamente, la funzione restituisce FALSE. Per altre osservazioni sull'uso appropriato delle coordinate di posizionamento delle finestre, vedere WINDOWPLACEMENT.

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-0 (introdotto in Windows 8)

Vedi anche

Informazioni concettuali

Riferimento

SetWindowPlacement

WINDOWPLACEMENT

Windows