SetBkColor 함수(wingdi.h)
SetBkColor 함수는 현재 배경색을 지정된 색 값으로 설정하거나 디바이스가 지정된 색 값을 나타낼 수 없는 경우 가장 가까운 실제 색으로 설정합니다.
구문
COLORREF SetBkColor(
[in] HDC hdc,
[in] COLORREF color
);
매개 변수
[in] hdc
디바이스 컨텍스트에 대한 핸들입니다.
[in] color
새 배경색입니다. COLORREF 값을 만들려면 RGB 매크로를 사용합니다.
반환 값
함수가 성공하면 반환 값은 이전 배경색을 COLORREF 값으로 지정합니다.
함수가 실패하면 반환 값은 CLR_INVALID입니다.
설명
이 함수는 CreatePen 함수에서 만든 펜을 사용하여 그려진 스타일이 지정된 선 사이의 간격을 채웁니다. ExtCreatePen 함수에서 만든 펜을 사용하여 그려진 스타일이 지정된 선 사이의 간격을 채우지 않습니다. SetBkColor 함수는 TextOut 및 ExtTextOut의 배경색도 설정합니다.
배경 모드가 OPAQUE인 경우 배경색은 스타일이 지정된 선, 브러시의 빗살 무늬 선 간 간격 및 문자 셀 사이의 간격을 채우는 데 사용됩니다. 비트맵을 색에서 단색으로 변환하거나 그 반대로 변환할 때도 배경색이 사용됩니다.
예제
예를 들어 메뉴 사용의 "Owner-Drawn 메뉴 항목 예제"를 참조 하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |