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

Función de devolución de llamada definida por la aplicación que se usa con la función EnumDisplayMonitors . El tipo MONITORENUMPROC define un puntero a esta función de devolución de llamada. MonitorEnumProc es un marcador de posición para el nombre de función definido por la aplicación.

Syntax

MONITORENUMPROC Monitorenumproc;

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

Parámetros

unnamedParam1

Tipo: HMONITOR

Identificador del monitor de visualización. Este valor siempre será distinto de NULL. Este parámetro se denomina normalmente hMonitor.

unnamedParam2

Tipo: HDC

Identificador de un contexto de dispositivo. Este parámetro se denomina normalmente hdcMonitor.

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 visualización.

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

unnamedParam3

Tipo: LPRECT

Puntero a una estructura RECT . Este parámetro se suele denominar lprcMonitor.

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

Tipo: LPARAM

Datos definidos por la aplicación que EnumDisplayMonitors pasan directamente a la función de enumeración. Este parámetro se denomina normalmente dwData.

Valor devuelto

Tipo: BOOL

Para continuar con la enumeración, devuelva TRUE.

Para detener la enumeración, devuelva FALSE.

Observaciones

Puede usar la función EnumDisplayMonitors para enumerar el conjunto de monitores de visualización 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 de los 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 visualizació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 de un contexto de dispositivo cuyo formato de color es adecuado para el monitor de pantalla. A continuación, puede pintar en el contexto del dispositivo de una manera óptima para el monitor de pantalla.

Requisitos

Consulte también

EnumDisplayMonitors

Funciones de varios monitores de visualización

Introducción a varios monitores de visualización