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 関数は、ディスプレイ モニターに適した色形式のデバイス コンテキストへのハンドルも受け取ります。 その後、ディスプレイ モニターに最適な方法でデバイス コンテキストにペイントできます。

要件

こちらもご覧ください

EnumDisplayMonitors

複数ディスプレイモニター機能

複数ディスプレイ モニターの概要