ExtFloodFill 函式 (wingdi.h)

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	填滿區域是由色彩所指定的色彩所定義。只要遇到色彩，填滿會繼續向外的所有方向。此樣式適用於填滿具有多重色彩界限的區域。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

以下是此函式可能會失敗的一些原因：

如果 fuFillType 參數是 FLOODFILLBORDER，系統會假設要填滿的區域完全受到 color 參數所指定的色彩所限定。函式會開始填滿 nXStart 和 nYStart 參數所指定的點，並繼續進行所有方向，直到到達界限為止。

如果 fuFillType 是 FLOODFILLSURFACE ，系統會假設要填滿的區域是單一色彩。函式會開始填滿 nXStart 和 nYStart 所指定點的區域，並繼續進行所有方向，填滿所有包含色彩所指定色彩的相鄰區域。

只有支援點陣顯示作業的記憶體裝置內容和裝置支援 ExtFloodFill 函式。若要判斷裝置是否支援這項技術，請使用 GetDeviceCaps 函式。

如需範例，請參閱使用功能表中的。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll