Funzione MonitorFromWindow (winuser.h)

  • Articolo

La funzione MonitorFromWindow recupera un handle per il monitor di visualizzazione con l'area più grande di intersezione con il rettangolo di delimitazione di una finestra specificata.

Sintassi

HMONITOR MonitorFromWindow(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

Parametri

[in] hwnd

Handle per la finestra di interesse.

[in] dwFlags

Determina il valore restituito della funzione se la finestra non interseca alcun monitor di visualizzazione.

Questo parametro può avere uno dei valori seguenti.

Valore Significato
MONITOR_DEFAULTTONEAREST
 Restituisce un handle per il monitor di visualizzazione più vicino alla finestra.
MONITOR_DEFAULTTONULL
 Restituisce NULL.
MONITOR_DEFAULTTOPRIMARY
 Restituisce un handle per il monitor di visualizzazione primario.

Valore restituito

Se la finestra interseca uno o più rettangoli di monitoraggio dello schermo, il valore restituito è un handle HMONITOR per il monitor di visualizzazione con l'area più grande di intersezione con la finestra.

Se la finestra non interseca un monitor di visualizzazione, il valore restituito dipende dal valore di dwFlags.

Commenti

Se la finestra è attualmente ridotta a icona, MonitorFromWindow usa il rettangolo della finestra prima che sia stato ridotto a icona.

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-sysparams-ext-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

MonitorFromPoint

MonitorFromRect

Funzioni monitor multiple

Panoramica dei monitoraggi multipli