共用方式為


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

傳回值

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

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

備註

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

  • 無法完成填滿。
  • 如果) 要求 FLOODFILLBORDER,則指定的點具有 color 參數所指定的界限色彩 (。
  • 如果要求) 的 FLOODFILLSURFACE,指定的點就不會有色彩 (指定的 色彩
  • 點位於裁剪區域之外,也就是說,它不會顯示在裝置上。
如果 fuFillType 參數是 FLOODFILLBORDER,系統會假設要填滿的區域完全受到 color 參數所指定的 色彩 所限定。 函式會開始填滿 nXStartnYStart 參數所指定的點,並繼續進行所有方向,直到到達界限為止。

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

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

範例

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

規格需求

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

另請參閱

點陣圖函式

位圖概觀

COLORREF

FloodFill

GetDeviceCaps

RGB