MONITORENUMPROC 回呼函式 （winuser.h）

與 EnumDisplayMonitors 函式搭配使用的應用程式定義回呼函式。 MONITORENUMPROC 類型會定義此回呼函式的指標。 MonitorEnumProc 是應用程式定義函式名稱的預留位置。

語法

MONITORENUMPROC Monitorenumproc;

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

參數

unnamedParam1

類型： HMONITOR

顯示監視器的控點。 此值一律為非 NULL。 此參數通常命名為 hMonitor。

unnamedParam2

類型： HDC

裝置內容的控制碼。 此參數通常命名為 hdcMonitor。

裝置內容具有適用於 hMonitor 所識別之顯示監視器的色彩屬性。 裝置內容的裁剪區域會設定為 EnumDisplayMonitors 的 hdc 參數所識別的裝置內容可見區域的交集、EnumDisplayMonitors 的 lprcClip 參數所指向的矩形，以及顯示監視器矩形。

如果 EnumDisplayMonitors 的 hdc 參數為 Null，則此值為 Null。

unnamedParam3

類型： LPRECT

RECT 結構的指標。 此參數通常命名為 lprcMonitor。

如果 hdcMonitor 為非 NULL，則此矩形是 hdcMonitor 所識別之裝置內容裁剪區域與顯示監視器矩形的交集。 矩形座標是裝置內容座標。

如果 hdcMonitor 為 Null，則此矩形是顯示監視器矩形。 矩形座標是虛擬螢幕座標。

unnamedParam4

類型： LPARAM

EnumDisplayMonitors 直接傳遞至列舉函式的應用程式定義資料。 此參數通常命名為 dwData。

返回值

類型： 布爾值

若要繼續列舉，請傳回 TRUE。

若要停止列舉，請傳回 FALSE。

備註

您可以使用 EnumDisplayMonitors 函式來列舉一組顯示監視器，這些監視器與指定裝置內容的可見區域相交，並選擇性地列舉裁剪矩形。 若要這樣做，請將 hdc 參數設定為非 Null 值，並視需要設定 lprcClip 參數。

您也可以使用 EnumDisplayMonitors 函式來列舉桌面上的一或多個顯示監視器，而不需要提供裝置內容。 若要這樣做，請將 EnumDisplayMonitors 的 hdc 參數設定為 Null，並視需要設定 lprcClip 參數。

在所有情況下， EnumDisplayMonitors 都會針對計算列舉集中的每個顯示監視器呼叫指定的 MonitorEnumProc 函式一次。 MonitorEnumProc 函式一律會接收顯示監視器的控制碼。

如果 EnumDisplayMonitors 的 hdc 參數為非 Null，則 MonitorEnumProc 函式也會接收裝置內容的控制碼，其色彩格式適用於顯示監視器。 然後，您可以以最適合顯示監視器的方式繪製到裝置內容中。

需求

另請參閱

列舉顯示監視器

多顯示器功能

多顯示器監視器概觀