Función MonitorFromRect (winuser.h)

  • Artículo

La función MonitorFromRect recupera un identificador para el monitor de visualización que tiene el área más grande de intersección con un rectángulo especificado.

Sintaxis

HMONITOR MonitorFromRect(
  [in] LPCRECT lprc,
  [in] DWORD   dwFlags
);

Parámetros

[in] lprc

Puntero a una estructura RECT que especifica el rectángulo de interés en coordenadas de pantalla virtual.

[in] dwFlags

Determina el valor devuelto de la función si el rectángulo 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 al rectángulo.
MONITOR_DEFAULTTONULL
 Devuelve NULL.
MONITOR_DEFAULTTOPRIMARY
 Devuelve un identificador al monitor de presentación principal.

Valor devuelto

Si el rectángulo 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 el rectángulo.

Si el rectángulo no interseca un monitor de presentación, el valor devuelto depende del valor de dwFlags.

Requisitos

Requisito Value
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

MonitorFromWindow

Funciones de varios monitores de presentación

Información general sobre varios monitores de visualización