(winuser.h) MONITORENUMPROC 回呼函式
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) |