GetThemeSysColorBrush 함수(uxtheme.h)

  • 아티클

시스템 색 브러시를 검색합니다.

구문

HBRUSH GetThemeSysColorBrush(
  [in] HTHEME hTheme,
  [in] int    iColorId
);

매개 변수

[in] hTheme

형식: HTHEME

테마 데이터에 대한 핸들입니다.

[in] iColorId

형식: int

원하는 시스템 색의 수를 지정하는 int 형식의 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
TMT_SCROLLBAR
 스크롤 막대의 색입니다.
TMT_배경
 배경의 색입니다.
TMT_ACTIVECAPTION
 현재 창에서 캡션 영역의 색입니다.
TMT_INACTIVECAPTION
 비활성 창의 캡션 영역 색입니다.
TMT_WINDOW
 창의 색입니다.
TMT_WINDOWFRAME
 창 주위의 프레임 색입니다.
TMT_MENUTEXT
 메뉴에 그려진 텍스트 색입니다.
TMT_WINDOWTEXT
 창에 그려진 텍스트 색입니다.
TMT_CAPTIONTEXT
 현재 창의 캡션 영역에 그려진 텍스트 색입니다.
TMT_ACTIVEBORDER
 활성 창 주위의 테두리 색입니다.
TMT_INACTIVEBORDER
 비활성 창 주위의 테두리 색입니다.
TMT_APPWORKSPACE
 애플리케이션 작업 영역의 색입니다.
TMT_HIGHLIGHT
 강조 표시 색입니다.
TMT_HIGHLIGHTTEXT
 강조 표시된 텍스트의 색입니다.
TMT_BTNFACE
 단추 얼굴의 색입니다.
TMT_BTNSHADOW
 단추 아래 그림자의 색입니다.
TMT_GRAYTEXT
 흐리게 표시된 텍스트의 색입니다.
TMT_BTNTEXT
 단추에 포함된 텍스트의 색입니다.
TMT_INACTIVECAPTIONTEXT
 비활성 창의 캡션 영역에 있는 텍스트의 색입니다.
TMT_BTNHIGHLIGHT
 단추 주위의 강조 표시 색입니다.
TMT_DKSHADOW3D
 3차원 어두운 그림자의 색입니다.
TMT_LIGHT3D
 3차원 조명 영역의 색입니다.
TMT_INFOTEXT
 정보 텍스트의 색입니다.
TMT_INFOBK
 정보 텍스트 뒤에 있는 배경의 색입니다.
TMT_BUTTONALTERNATEFACE
 단추의 대체 얼굴 색입니다.
TMT_HOTTRACKING
 사용자가 컨트롤 위로 마우스를 이동할 때 적용되는 강조 색입니다.
TMT_GRADIENTACTIVECAPTION
 현재 창의 캡션 영역에 적용된 그라데이션 색입니다.
TMT_GRADIENTINACTIVECAPTION
 비활성 창의 캡션 영역에 적용된 그라데이션 색입니다.
TMT_MENUHILIGHT
 사용자가 마우스를 위로 이동할 때 메뉴 항목에 그려진 강조 색입니다.
TMT_MENUBAR
 메뉴 모음의 색입니다.

반환 값

형식: HBRUSH

데이터를 브러시하는 핸들입니다.

설명

테마 데이터 핸들이 NULL 핸들이 아닌 경우 GetThemeSysColorBrush 는 비주얼 스타일의 SysMetrics 섹션에서 지정된 색과 일치하는 브러시를 반환합니다. 테마 데이터 핸들이 NULL이면 함수는 전역 시스템 색과 일치하는 브러시를 반환합니다.

DeleteObject를 사용하여 더 이상 필요하지 않은 경우 이 함수에서 반환되는 브러시 핸들을 해제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 uxtheme.h
라이브러리 UxTheme.lib
DLL UxTheme.dll