Compartir a través de

Función MonitorFromWindow (winuser.h)

  • Artículo

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