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 です。

戻り値

型: BOOL

列挙を続行するには、 TRUE を返します。

列挙を停止するには、 FALSE を返します。

注釈

EnumDisplayMonitors 関数を使用すると、指定したデバイス コンテキストの表示領域と、必要に応じてクリッピング四角形と交差するディスプレイ モニターのセットを列挙できます。 これを行うには、 hdc パラメーターを NULL 以外の値に設定し、必要に応じて lprcClip パラメーターを設定します。

EnumDisplayMonitors 関数を使用して、デバイス コンテキストを指定せずに、デスクトップ上の 1 つ以上のディスプレイ モニターを列挙することもできます。 これを行うには、EnumDisplayMonitors の hdc パラメーターを NULL に設定し、必要に応じて lprcClip パラメーターを設定します。

いずれの場合も、 EnumDisplayMonitors は、計算された列挙セット内の各ディスプレイ モニターに対して、指定された MonitorEnumProc 関数を 1 回呼び出します。 MonitorEnumProc 関数は、常にディスプレイ モニターへのハンドルを受け取ります。

EnumDisplayMonitors の hdc パラメーターが NULL 以外の場合、MonitorEnumProc 関数は、ディスプレイ モニターに適した色形式のデバイス コンテキストへのハンドルも受け取ります。 その後、ディスプレイ モニターに最適な方法でデバイス コンテキストにペイントできます。

Requirements

こちらも参照ください

EnumDisplayMonitors

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

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