Función MonitorFromWindow (winuser.h)

La función MonitorFromWindow recupera un identificador para el monitor de visualización que tiene el área más grande de intersección con el rectángulo delimitador de una ventana especificada.

Sintaxis

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

Parámetros

[in] hwnd

Identificador de la ventana de interés.

[in] dwFlags

Determina el valor devuelto de la función si la ventana no interseca ningún monitor de presentación.

Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
MONITOR_DEFAULTTONEAREST	Devuelve un identificador al monitor de pantalla más cercano a la ventana.
MONITOR_DEFAULTTONULL	Devuelve NULL.
MONITOR_DEFAULTTOPRIMARY	Devuelve un identificador al monitor de presentación principal.

Valor devuelto

Si la ventana interseca uno o varios rectángulos del monitor de visualización, el valor devuelto es un identificador HMONITOR para el monitor de visualización que tiene el área más grande de intersección con la ventana.

Si la ventana no forma una intersección con un monitor de presentación, el valor devuelto depende del valor de dwFlags.

Comentarios

Si la ventana está minimizada actualmente, MonitorFromWindow usa el rectángulo de la ventana antes de que se minimice.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introducido en Windows 10, versión 10.0.14393)

Consulte también

MonitorFromPoint

MonitorFromRect

Funciones de varios monitores de presentación

Información general sobre varios monitores de visualización