FillRect 函式 (winuser.h)

發行項
08/27/2023

FillRect函式會使用指定的筆刷填滿矩形。此函式包含左框線和上框線，但會排除矩形的右框線和下框線。

語法

int FillRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

參數

[in] hDC

裝置內容的控制碼。

[in] lprc

RECT結構的指標，其中包含要填滿之矩形的邏輯座標。

[in] hbr

筆刷的控制碼，用來填滿矩形。

傳回值

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

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

備註

hbr參數所識別的筆刷可以是邏輯筆刷或色彩值的控制碼。如果指定邏輯筆刷的控制碼，請呼叫下列其中一個函式來取得控制碼： CreateHatchBrush、 CreatePatternBrush或 CreateSolidBrush。此外，您可以使用 GetStockObject 函式來擷取其中一個股票筆刷的控制碼。如果指定 hbr 參數的色彩值，它必須是其中一種標準系統色彩， (值 1 必須新增至所選的色彩) 。例如：


FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));

如需所有標準系統色彩的清單，請參閱 GetSysColor。

填滿指定的矩形時， FillRect 不包含矩形的右和下側。不論目前的對應模式為何，GDI 會向上填滿矩形，但不包括右欄和底端資料列。

範例

如需範例，請參閱使用矩形。

規格需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-gui-l1-1-0 (在 Windows 8)