Función EnumDisplayMonitors (winuser.h)
La función EnumDisplayMonitors enumera los monitores de visualización (incluidos pseudo monitores invisibles asociados a los controladores de creación de reflejo) que intersecan una región formada por la intersección de un rectángulo de recorte especificado y la región visible de un contexto de dispositivo. EnumDisplayMonitors llama a una función de devolución de llamada MonitorEnumProc definida por la aplicación una vez para cada monitor que se enumera. Tenga en cuenta que GetSystemMetrics (SM_CMONITORS) solo cuenta los monitores de visualización.
Sintaxis
BOOL EnumDisplayMonitors(
[in] HDC hdc,
[in] LPCRECT lprcClip,
[in] MONITORENUMPROC lpfnEnum,
[in] LPARAM dwData
);
Parámetros
[in] hdc
Identificador de un contexto de dispositivo de visualización que define la región visible de interés.
Si este parámetro es NULL, el parámetro hdcMonitor pasado a la función de devolución de llamada será NULL y la región visible de interés es la pantalla virtual que abarca todas las pantallas del escritorio.
[in] lprcClip
Puntero a una estructura RECT que especifica un rectángulo de recorte. La región de interés es la intersección del rectángulo de recorte con la región visible especificada por hdc.
Si hdc no es NULL, las coordenadas del rectángulo de recorte son relativas al origen del hdc. Si hdc es NULL, las coordenadas son coordenadas de pantalla virtual.
Este parámetro puede ser NULL si no desea recortar la región especificada por hdc.
[in] lpfnEnum
Puntero a una función de devolución de llamada definida por la aplicación MonitorEnumProc .
[in] dwData
Datos definidos por la aplicación que EnumDisplayMonitors pasan directamente a la función MonitorEnumProc .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Hay dos razones para llamar a la función EnumDisplayMonitors :
- Quiere dibujar de forma óptima en un contexto de dispositivo que abarque varios monitores de pantalla y los monitores tengan diferentes formatos de color.
- Quiere obtener un identificador y un rectángulo de posición para uno o varios monitores de visualización.
No es necesario usar la función EnumDisplayMonitors cuando una ventana abarca monitores de visualización con distintos formatos de color. Puede seguir pintando bajo la suposición de que toda la pantalla tiene las propiedades de color del monitor principal. Las ventanas se verán bien. EnumDisplayMonitors solo te permite hacer que se vean mejor.
Establecer el parámetro hdc en NULL permite usar la función EnumDisplayMonitors para obtener un rectángulo de identificador y posición para uno o varios monitores de pantalla. En la tabla siguiente se muestra cómo las cuatro combinaciones de valores NULL y no NULLhdc y lprcClip afectan al comportamiento de la función EnumDisplayMonitors .
| hdc | lprcRect | Comportamiento de EnumDisplayMonitors |
|---|---|---|
| NULL | NULL | Enumera todos los monitores de visualización. La función de devolución de llamada recibe un HDC NULL . |
| NULL | no NULL | Enumera todos los monitores de visualización que intersecan el rectángulo de recorte. Use coordenadas de pantalla virtual para el rectángulo de recorte. La función de devolución de llamada recibe un HDC NULL . |
| no NULL | NULL | Enumera todos los monitores de visualización que intersecan la región visible del contexto del dispositivo. La función de devolución de llamada recibe un identificador de controlador de dominio para el monitor de visualización específico. |
| no NULL | no NULL | Enumera todos los monitores de visualización que intersecan la región visible del contexto del dispositivo y el rectángulo de recorte. Use coordenadas de contexto del dispositivo para el rectángulo de recorte. La función de devolución de llamada recibe un identificador de controlador de dominio para el monitor de visualización específico. |
Ejemplos
Para pintar en respuesta a un mensaje de WM_PAINT, con las funcionalidades de cada monitor, puede usar código como este en un procedimiento de ventana:
case WM_PAINT:
hdc = BeginPaint(hwnd, &ps);
EnumDisplayMonitors(hdc, NULL, MyPaintEnumProc, 0);
EndPaint(hwnd, &ps);
Para pintar la mitad superior de una ventana con las funcionalidades de cada monitor, puede usar código similar al siguiente:
GetClientRect(hwnd, &rc);
rc.bottom = (rc.bottom - rc.top) / 2;
hdc = GetDC(hwnd);
EnumDisplayMonitors(hdc, &rc, MyPaintEnumProc, 0);
ReleaseDC(hwnd, hdc);
Para pintar la pantalla virtual completa de forma óptima para cada monitor de pantalla, puede usar código similar al siguiente:
hdc = GetDC(NULL);
EnumDisplayMonitors(hdc, NULL, MyPaintScreenEnumProc, 0);
ReleaseDC(NULL, hdc);
Para recuperar información sobre todos los monitores de visualización, use código similar al siguiente:
EnumDisplayMonitors(NULL, NULL, MyInfoEnumProc, 0);
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 (incluya 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) |