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

另請參閱

EnumDisplayMonitors

多個顯示監視器函式

多個顯示監視器概觀