SetBkColor 함수(wingdi.h)

아티클
08/27/2023

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