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) |