Функция обратного вызова MONITORENUMPROC (winuser.h)

  • Статья

Функция MonitorEnumProc — это определяемая приложением функция обратного вызова, вызываемая функцией EnumDisplayMonitors .

Значение типа MONITORENUMPROC является указателем на функцию MonitorEnumProc .

Синтаксис

MONITORENUMPROC Monitorenumproc;

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

Параметры

unnamedParam1

Дескриптор монитора дисплея. Это значение всегда не равно NULL.

unnamedParam2

Дескриптор для контекста устройства.

Контекст устройства содержит атрибуты цвета, соответствующие монитору дисплея, определяемого hMonitor. Область обрезки контекста устройства устанавливается на пересечение видимой области контекста устройства, определяемой параметром hdcEnumDisplayMonitors, прямоугольником, на который указывает параметр lprcClipenumDisplayMonitors, и прямоугольником монитора дисплея.

Это значение равно NULL , если параметр hdcenumDisplayMonitors имеет значение NULL.

unnamedParam3

Указатель на структуру RECT .

Если hdcMonitor не равно NULL, этот прямоугольник является пересечением области обрезки контекста устройства, определяемого hdcMonitor , и прямоугольника монитора дисплея. Координаты прямоугольника являются координатами контекста устройства.

Если hdcMonitor имеет значение NULL, этот прямоугольник является прямоугольником монитора дисплея. Прямоугольные координаты являются координатами виртуального экрана.

unnamedParam4

Определяемые приложением данные, которые EnumDisplayMonitors передают непосредственно в функцию перечисления.

Возвращаемое значение

Чтобы продолжить перечисление, верните значение TRUE.

Чтобы остановить перечисление, верните значение FALSE.

Комментарии

Функцию EnumDisplayMonitors можно использовать для перечисления набора мониторов отображения, которые пересекаются с видимой областью указанного контекста устройства, и при необходимости прямоугольника обрезки. Для этого задайте для параметра hdc значение, отличное от NULL , и при необходимости задайте параметр lprcClip .

Функцию EnumDisplayMonitors можно также использовать для перечисления одного или нескольких мониторов на рабочем столе без указания контекста устройства. Для этого задайте для параметра hdcEnumDisplayMonitorsзначение NULL и при необходимости задайте параметр lprcClip .

Во всех случаях EnumDisplayMonitors вызывает указанную функцию MonitorEnumProc один раз для каждого монитора дисплея в вычисляемом наборе перечислений. Функция MonitorEnumProc всегда получает дескриптор монитора дисплея.

Если параметр hdcEnumDisplayMonitors не равен NULL, функция MonitorEnumProc также получает дескриптор контекста устройства, цветовой формат которого подходит для монитора дисплея. Затем можно зарисовать в контексте устройства способом, оптимальным для монитора дисплея.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)

См. также раздел

EnumDisplayMonitors

Функции мониторов с несколькими дисплеями

Обзор мониторов с несколькими дисплеями