Función de devolución de llamada MONITORENUMPROC (winuser.h)

Una función MonitorEnumProc es una función de devolución de llamada definida por la aplicación a la que llama la función EnumDisplayMonitors .

Un valor de tipo MONITORENUMPROC es un puntero a una función MonitorEnumProc .

Sintaxis

MONITORENUMPROC Monitorenumproc;

BOOL Monitorenumproc(
  HMONITOR unnamedParam1,
  HDC unnamedParam2,
  LPRECT unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parámetros

unnamedParam1

Identificador del monitor de pantalla. Este valor siempre será distinto de NULL.

unnamedParam2

Identificador de un contexto de dispositivo.

El contexto del dispositivo tiene atributos de color adecuados para el monitor de visualización identificado por hMonitor. El área de recorte del contexto del dispositivo se establece en la intersección de la región visible del contexto del dispositivo identificado por el parámetro hdc de EnumDisplayMonitors, el rectángulo al que apunta el parámetro lprcClip de EnumDisplayMonitors y el rectángulo del monitor de pantalla.

Este valor es NULL si el parámetro hdc de EnumDisplayMonitors era NULL.

unnamedParam3

Puntero a una estructura RECT .

Si hdcMonitor no es NULL, este rectángulo es la intersección del área de recorte del contexto del dispositivo identificado por hdcMonitor y el rectángulo del monitor de pantalla. Las coordenadas del rectángulo son coordenadas de contexto del dispositivo.

Si hdcMonitor es NULL, este rectángulo es el rectángulo del monitor de pantalla. Las coordenadas del rectángulo son coordenadas de pantalla virtual.

unnamedParam4

Datos definidos por la aplicación que EnumDisplayMonitors pasan directamente a la función de enumeración.

Valor devuelto

Para continuar con la enumeración, devuelva TRUE.

Para detener la enumeración, devuelva FALSE.

Comentarios

Puede usar la función EnumDisplayMonitors para enumerar el conjunto de monitores de pantalla que intersecan la región visible de un contexto de dispositivo especificado y, opcionalmente, un rectángulo de recorte. Para ello, establezca el parámetro hdc en un valor distinto de NULL y establezca el parámetro lprcClip según sea necesario.

También puede usar la función EnumDisplayMonitors para enumerar uno o varios monitores de pantalla en el escritorio, sin proporcionar un contexto de dispositivo. Para ello, establezca el parámetro hdc de EnumDisplayMonitors en NULL y establezca el parámetro lprcClip según sea necesario.

En todos los casos, EnumDisplayMonitors llama a una función MonitorEnumProc especificada una vez para cada monitor de presentación del conjunto de enumeración calculado. La función MonitorEnumProc siempre recibe un identificador para el monitor de visualización.

Si el parámetro hdc de EnumDisplayMonitors no es NULL, la función MonitorEnumProc también recibe un identificador a un contexto de dispositivo cuyo formato de color es adecuado para el monitor de pantalla. Después, puede pintar en el contexto del dispositivo de una manera óptima para el monitor de pantalla.

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)

Consulte también

EnumDisplayMonitors

Funciones de varios monitores de presentación

Información general sobre varios monitores de visualización