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
要執行的填滿作業類型。 此參數必須是下列其中一個值。
值 | 意義 |
---|---|
|
填滿區域是由 color 參數所指定的色彩所限定。 此樣式與 FloodFill 函式所執行的填滿相同。 |
|
填滿區域是由色彩所指定的 色彩所定義。 只要遇到色彩,填滿會繼續向外的所有方向。 此樣式適用於填滿具有多重色彩界限的區域。 |
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
備註
以下是此函式可能會失敗的一些原因:
- 無法完成填滿。
- 如果) 要求 FLOODFILLBORDER,則指定的點具有 color 參數所指定的界限色彩 (。
- 如果要求) 的 FLOODFILLSURFACE,指定的點就不會有色彩 (指定的 色彩 。
- 點位於裁剪區域之外,也就是說,它不會顯示在裝置上。
如果 fuFillType 是 FLOODFILLSURFACE ,系統會假設要填滿的區域是單一色彩。 函式會開始填滿 nXStart 和 nYStart 所指定點的區域,並繼續進行所有方向,填滿所有包含 色彩所指定色彩的相鄰區域。
只有支援點陣顯示作業的記憶體裝置內容和裝置支援 ExtFloodFill 函式。 若要判斷裝置是否支援這項技術,請使用 GetDeviceCaps 函式。
範例
如需範例,請參閱 使用功能表中的。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |