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