FillRect 함수(winuser.h)
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에서 도입) |