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

사각형을 채우는 데 사용되는 브러시에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

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에서 도입)