Struttura WINDOWPLACEMENT (winuser.h)

Articolo
08/28/2023

Contiene informazioni sulla posizione di una finestra sullo schermo.

Sintassi

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

Members

length

Tipo: UINT

Lunghezza della struttura, in byte. Prima di chiamare le funzioni GetWindowPlacement o SetWindowPlacement , impostare questo membro su sizeof(WINDOWPLACEMENT).

GetWindowPlacement e SetWindowPlacement hanno esito negativo se questo membro non è impostato correttamente.

flags

Tipo: UINT

Flag che controllano la posizione della finestra ridotta a icona e il metodo in base al quale viene ripristinata la finestra. Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
WPF_ASYNCWINDOWPLACEMENT 0x0004	Se il thread chiamante e il thread proprietario della finestra sono collegati a code di input diverse, il sistema invia la richiesta al thread proprietario della finestra. Ciò impedisce al thread chiamante di bloccare l'esecuzione mentre altri thread elaborano la richiesta.
WPF_RESTORETOMAXIMIZED 0x0002	La finestra ripristinata verrà ingrandita, indipendentemente dal fatto che sia stata ingrandita prima che sia stata ridotta a icona. Questa impostazione è valida solo alla successiva ripristino della finestra. Non modifica il comportamento di ripristino predefinito. Questo flag è valido solo quando viene specificato il valore SW_SHOWMINIMIZED per il membro showCmd .
WPF_SETMINPOSITION 0x0001	È possibile specificare le coordinate della finestra ridotta a icona. Questo flag deve essere specificato se le coordinate sono impostate nel membro ptMinPosition .

showCmd

Tipo: UINT

Stato corrente della finestra. Può essere uno qualsiasi dei valori che è possibile specificare nel parametro nCmdShow per la funzione ShowWindow .

ptMinPosition

Tipo: POINT

Coordinate dell'angolo superiore sinistro della finestra quando la finestra è ridotta a icona.

ptMaxPosition

Tipo: POINT

Coordinate dell'angolo superiore sinistro della finestra quando la finestra è ingrandita.

rcNormalPosition

Tipo: RECT

Le coordinate della finestra quando la finestra si trova nella posizione ripristinata.

rcDevice

Commenti

Se la finestra è una finestra di primo livello che non ha lo stile della finestra WS_EX_TOOLWINDOW , le coordinate rappresentate dai membri seguenti si trovano nelle coordinate dell'area di lavoro: ptMinPosition, ptMaxPosition e rcNormalPosition. In caso contrario, questi membri si trovano nelle coordinate dello schermo.

Le coordinate dell'area di lavoro differiscono dalle coordinate dello schermo in quanto prendono in considerazione le posizioni e le dimensioni delle barre degli strumenti dell'applicazione (inclusa la barra delle applicazioni). La coordinata dell'area di lavoro (0,0) è l'angolo superiore sinistro dell'area di lavoro, ovvero l'area dello schermo non usata dalle barre degli strumenti dell'applicazione.

Le coordinate usate in una struttura WINDOWPLACEMENT devono essere usate solo dalle funzioni GetWindowPlacement e SetWindowPlacement . Il passaggio delle coordinate dell'area di lavoro alle funzioni che prevedono coordinate dello schermo (ad esempio SetWindowPos) comporterà la visualizzazione della finestra nella posizione errata. Ad esempio, se la barra delle applicazioni si trova nella parte superiore dello schermo, salvando le coordinate della finestra usando GetWindowPlacement e ripristinandole tramite SetWindowPos , la finestra appare "strisciare" sullo schermo.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winuser.h (include Windows.h)