MONITORENUMPROC 回调函数 (winuser.h)

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

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

语法

MONITORENUMPROC Monitorenumproc;

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

参数

unnamedParam1

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

unnamedParam2

设备上下文的句柄。

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

如果 EnumDisplayMonitorshdc 参数为 NULL,则此值为 NULL

unnamedParam3

指向 RECT 结构的指针。

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

如果 hdcMonitorNULL,则此矩形是显示监视器矩形。 矩形坐标是虚拟屏幕坐标。

unnamedParam4

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

返回值

若要继续枚举,请返回 TRUE

若要停止枚举,请返回 FALSE

注解

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

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

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

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

要求

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

另请参阅

EnumDisplayMonitors

多个显示监视器函数

多个显示监视器概述