ExtFloodFill 関数 (wingdi.h)

[アーティクル]
03/04/2024

ExtFloodFill 関数は、表示サーフェスの領域を現在のブラシで塗りつぶします。

構文

BOOL ExtFloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color,
  [in] UINT     type
);

パラメーター

[in] hdc

デバイスコンテキストを識別するハンドル。

[in] x

塗りつぶしを開始するポイントの x 座標を論理単位で指定します。

[in] y

塗りつぶしが開始されるポイントの y 座標 (論理単位)。

[in] color

塗りつぶす境界または領域の色。色の解釈は、fuFillType パラメーターの値によって異なります。 COLORREF カラー値を作成するには、RGB マクロを使用します。

[in] type

実行する塗りつぶし操作の種類。このパラメーターには次のいずれかの値を指定する必要があります。

値	意味
FLOODFILLBORDER	塗りつぶし領域は、 color パラメーターで指定された色で囲まれます。このスタイルは、 FloodFill 関数によって実行される塗りつぶしと同じです。
FLOODFILLSURFACE	塗りつぶし領域は、色で指定された色によって定義されます。塗りつぶしは、色が検出される限り、すべての方向に外側に続きます。このスタイルは、多色の境界で領域を塗りつぶす場合に便利です。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

注釈

この関数が失敗する原因の一部を次に示します。

充填を完了できませんでした。
指定したポイントには、color パラメーターで指定された境界の色があります (FLOODFILLBORDER が要求された場合)。
指定したポイントには、色で指定された色がありません (FLOODFILLSURFACE が要求された場合)。
ポイントがクリッピング領域の外側、つまりデバイスに表示されません。

fuFillType パラメーターが FLOODFILLBORDER の場合、塗りつぶされる領域は color パラメーターで指定された色で完全に囲まれていると想定されます。関数は、 nXStart パラメーターと nYStart パラメーターで指定されたポイントから入力を開始し、境界に達するまですべての方向に続きます。

fuFillType が FLOODFILLSURFACE の場合、塗りつぶす領域は 1 色であるとシステムで想定されます。関数は、 nXStart と nYStart で指定されたポイントで領域の塗りつぶしを開始し、すべての方向に続き、色で指定された色を含むすべての隣接する領域を塗りつぶします。

ExtFloodFill 関数をサポートするのは、ラスター表示操作をサポートするメモリデバイスコンテキストとデバイスのみです。デバイスがこのテクノロジをサポートしているかどうかを確認するには、 GetDeviceCaps 関数を使用します。

例

例については、「メニューの使用」の「メニューへの線とグラフの追加」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll