MONITORENUMPROC コールバック関数 (winuser.h)
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 関数を使用して、デバイス コンテキストを指定せずに、デスクトップ上の 1 つ以上のディスプレイ モニターを列挙することもできます。 これを行うには、EnumDisplayMonitors の hdc パラメーターを NULL に設定し、必要に応じて lprcClip パラメーターを設定します。
EnumDisplayMonitors は、計算された列挙セット内のディスプレイ モニターごとに、指定した MonitorEnumProc 関数を 1 回呼び出します。 MonitorEnumProc 関数は、常にディスプレイ モニターへのハンドルを受け取ります。
EnumDisplayMonitors の hdc パラメーターが NULL 以外の場合、MonitorEnumProc 関数は、ディスプレイ モニターに適した色形式のデバイス コンテキストへのハンドルも受け取ります。 その後、ディスプレイ モニターに最適な方法でデバイス コンテキストにペイントできます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |