GetSysColorBrush 함수(winuser.h)

아티클
03/04/2024

GetSysColorBrush 함수는 지정된 색 인덱스에 해당하는 논리 브러시를 식별하는 핸들을 검색합니다.

구문

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

매개 변수

[in] nIndex

색 인덱스입니다. 이 값은 창 요소 중 하나를 그리는 데 사용되는 색에 해당합니다. 시스템 색 인덱스 값은 GetSysColor 를 참조하세요.

반환 값

반환 값은 nIndex 매개 변수가 현재 플랫폼에서 지원되는 경우 논리 브러시를 식별합니다. 그렇지 않으면 NULL을 반환합니다.

설명

브러시는 시스템에서 채워진 셰이프의 내부를 그리는 데 사용하는 비트맵입니다. 애플리케이션은 GetSysColor 함수를 호출하여 현재 시스템 색을 검색할 수 있습니다. 애플리케이션은 SetSysColors 함수를 호출하여 현재 시스템 색을 설정할 수 있습니다.

애플리케이션은 시스템 브러시를 사용하여 창에 대한 창 클래스를 등록해서는 안 됩니다. 시스템 색으로 창 클래스를 등록하려면 WNDCLASS 또는 WNDCLASSEX 구조체의 hbrBackground 멤버 설명서를 참조하세요.

시스템 색 브러시는 시스템 색의 변화를 추적합니다. 즉, 사용자가 시스템 색을 변경하면 연결된 시스템 색 브러시가 자동으로 새 색으로 변경됩니다.

시스템 색 브러시로 페인트하려면 GetSysColorBrush 가 새 브러시를 할당하는 대신 캐시된 브러시를 반환하므로 애플리케이션은 CreateSolidBrush ( GetSysColor (nIndex)) 대신 GetSysColorBrush (nIndex)를 사용해야 합니다.

시스템 색 브러시는 시스템에서 소유하므로 삭제할 필요가 없습니다. GetSysColorBrush가 반환하는 논리 브러시를 삭제할 필요는 없지만 DeleteObject를 호출하면 아무런 피해도 발생하지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-gui-l1-1-1(Windows 8.1 도입)