描述
MonitorEnumProc函数是由EnumDisplayMonitors函数调用的应用程序定义的回调函数。
类型为MONITORENUMPROC的值是指向MonitorEnumProc函数的指针。
C++ 语法
BOOL CALLBACK MonitorEnumProc( __in HMONITOR hMonitor, __in HDC hdcMonitor, __in LPRECT lprcMonitor, __in LPARAM dwData ); |
PowerBASIC 语法
FUNCTION MonitorEnumProc ( _ BYVAL hMonitor AS DWORD, _ BYVAL hdcMonitor AS DWORD, _ BYREF lprcMonitor AS RECT, _ BYVAL dwData AS DWORD _ ) AS LONG |
参数
hMonitor
[in]处理显示监视器。此值将始终为非NULL。
hdcMonitor
[in]处理设备上下文。
设备上下文具有适用于由HMONITORsk标识的显示监视器的颜色属性。设备上下文的剪切区域设置为由EnumDisplayMonitors的hDC参数（lprcClip参数EnumDisplayMonitors指向的矩形）标识的设备上下文的可见区域与显示器监视矩形。
如果EnumDisplayMonitors的hDC参数为NULL，则此值为NULL。
lprcMonitor
[in]指向RECT结构的指针。
如果hdcMonitor不为NULL，则此矩形是由hdcMonitor标识的设备上下文的剪切区域与显示监视矩形的交集。矩形坐标是设备上下文坐标。
如果hdcMonitor为NULL，则该矩形是显示监视器矩形。矩形坐标是虚拟屏幕坐标。
dwData
[in]应用程序定义的数据，EnumDisplayMonitors直接传递给枚举函数。
返回值
要继续枚举，返回TRUE。
要停止枚举，返回FALSE。
备注
您可以使用EnumDisplayMonitors函数枚举与指定设备上下文的可见区域相交的显示监视器集，以及可选的剪切矩形。为此，将hdc参数设置为非NULL值，并根据需要设置lprcClip参数。
您还可以使用EnumDisplayMonitors功能枚举桌面上的一个或多个显示器，而不提供设备上下文。为此，请将EnumDisplayMonitors的hDC参数设置为NULL，并根据需要设置lprcClip参数。
在所有情况下，EnumDisplayMonitors在计算的枚举集中为每个显示监视器调用一次指定的MonitorEnumProc函数。MonitorEnumProc功能总是接收到显示监视器的句柄。
如果EnumDisplayMonitors的EnumDisplayMonitors参数不为NULL，则MonitorEnumProc功能也会接收到其颜色格式适合显示监视器的设备上下文的句柄。然后，您可以以最适合显示监视器的方式绘制到设备上下文中。
引用文件 #INCLUDE Once
WinUser.inc（包括Windows.inc）