MONITORENUMPROC 回调函数 (winuser.h)

MonitorEnumProc 函数是由 EnumDisplayMonitors 函数调用的应用程序定义的回调函数。

MONITORENUMPROC 类型的值是指向 MonitorEnumProc 函数的指针。

语法

MONITORENUMPROC Monitorenumproc;

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

参数

unnamedParam1

显示监视器的句柄。 此值将始终为非 NULL。

unnamedParam2

设备上下文的句柄。

设备上下文具有适合 由 hMonitor 标识的显示器的颜色属性。 设备上下文的剪裁区域设置为由 EnumDisplayMonitors 的 hdc 参数标识的设备上下文的可见区域的交集、EnumDisplayMonitors 的 lprcClip 参数所指向的矩形以及显示监视器矩形。

如果 EnumDisplayMonitors 的 hdc 参数为 NULL，则此值为 NULL。

unnamedParam3

指向 RECT 结构的指针。

如果 hdcMonitor 为非 NULL，则此矩形是 hdcMonitor 标识的设备上下文与显示监视器矩形的剪切区域的交集。 矩形坐标是设备上下文坐标。

如果 hdcMonitor 为 NULL，则此矩形是显示监视器矩形。 矩形坐标是虚拟屏幕坐标。

unnamedParam4

EnumDisplayMonitors 直接传递给枚举函数的应用程序定义数据。

返回值

若要继续枚举，请返回 TRUE。

若要停止枚举，请返回 FALSE。

注解

可以使用 EnumDisplayMonitors 函数枚举与指定设备上下文的可见区域（可选）相交的显示监视器集。 为此，请将 hdc 参数设置为非 NULL 值，并根据需要设置 lprcClip 参数。

还可以使用 EnumDisplayMonitors 函数枚举桌面上的一个或多个显示监视器，而无需提供设备上下文。 为此，请将 EnumDisplayMonitors 的 hdc 参数设置为 NULL，并根据需要设置 lprcClip 参数。

在所有情况下， EnumDisplayMonitors 为计算枚举集中的每个显示监视器调用一次指定的 MonitorEnumProc 函数。 MonitorEnumProc 函数始终接收显示监视器的句柄。

如果 EnumDisplayMonitors 的 hdc 参数为非 NULL，则 MonitorEnumProc 函数还会接收颜色格式适合显示监视器的设备上下文的句柄。 然后，可以采用最适合显示监视器的方式绘制到设备上下文中。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)

另请参阅

EnumDisplayMonitors

多个显示监视器函数

多个显示监视器概述