GetSysColor 함수(winuser.h)

지정된 표시 요소의 현재 색을 검색합니다. 표시 요소는 창의 부분이며 시스템 디스플레이 화면에 표시되는 디스플레이입니다.

구문

DWORD GetSysColor(
  [in] int nIndex
);

매개 변수

[in] nIndex

형식: int

색을 검색할 표시 요소입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

의미
COLOR_3DDKSHADOW
21
3차원 디스플레이 요소에 대한 어두운 그림자입니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_3DFACE
15
3차원 디스플레이 요소 및 대화 상자 배경에 대한 얼굴 색입니다.
COLOR_3DHIGHLIGHT
20
3차원 디스플레이 요소의 강조 색(광원을 향한 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_3DHILIGHT
20
3차원 디스플레이 요소의 강조 색(광원을 향한 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_3DLIGHT
22
3차원 디스플레이 요소의 밝은 색(광원을 향한 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_3DSHADOW
16
3차원 디스플레이 요소의 그림자 색(광원에서 멀리 있는 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_ACTIVEBORDER
10
활성 창 테두리입니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_ACTIVECAPTION
2
활성 창 제목 표시줄.

연결된 전경색이 COLOR_CAPTIONTEXT.

그라데이션 효과를 사용하는 경우 현재 창 제목 표시줄의 색 그라데이션에서 왼쪽 색을 지정합니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_APPWORKSPACE
12
여러 MDI(문서 인터페이스) 애플리케이션의 배경색입니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BACKGROUND
1
데스크톱.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BTNFACE
15
3차원 디스플레이 요소 및 대화 상자 배경에 대한 얼굴 색입니다. 연결된 전경색이 COLOR_BTNTEXT.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BTNHIGHLIGHT
20
3차원 디스플레이 요소의 강조 색(광원을 향한 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BTNHILIGHT
20
3차원 디스플레이 요소의 강조 색(광원을 향한 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BTNSHADOW
16
3차원 디스플레이 요소의 그림자 색(광원에서 멀리 있는 가장자리의 경우).

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_BTNTEXT
18
누름 단추의 텍스트입니다. 연결된 배경색이 COLOR_BTNFACE.
COLOR_CAPTIONTEXT
9
캡션, 크기 상자 및 스크롤 막대 화살표 상자의 텍스트입니다. 연결된 배경색이 COLOR_ACTIVECAPTION.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_DESKTOP
1
데스크톱.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_GRADIENTACTIVECAPTION
27
현재 창 제목 표시줄의 색 그라데이션에서 오른쪽 색입니다. COLOR_ACTIVECAPTION 왼쪽 색을 지정합니다. SystemParametersInfo 함수와 함께 SPI_GETGRADIENTCAPTIONS 사용하여 그라데이션 효과를 사용할 수 있는지 여부를 확인합니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_GRADIENTINACTIVECAPTION
28
비활성 창 제목 표시줄의 색 그라데이션에서 오른쪽 색입니다. COLOR_INACTIVECAPTION 왼쪽 색을 지정합니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_GRAYTEXT
17
회색(사용 안 함) 텍스트입니다. 현재 디스플레이 드라이버가 단색 회색을 지원하지 않는 경우 이 색은 0으로 설정됩니다.
COLOR_HIGHLIGHT
13
컨트롤에서 선택된 항목입니다. 연결된 전경색이 COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT
14
컨트롤에서 선택된 항목의 텍스트입니다. 연결된 배경색이 COLOR_HIGHLIGHT.
COLOR_HOTLIGHT
26
하이퍼링크 또는 핫 트랙 항목의 색입니다. 연결된 배경색이 COLOR_WINDOW.
COLOR_INACTIVEBORDER
11
비활성 창 테두리입니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_INACTIVECAPTION
3
비활성 창 캡션.

연결된 전경색이 COLOR_INACTIVECAPTIONTEXT.

그라데이션 효과를 사용하는 경우 비활성 창 제목 표시줄의 색 그라데이션에서 왼쪽 색을 지정합니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_INACTIVECAPTIONTEXT
19
비활성 캡션 텍스트 색입니다. 연결된 배경색이 COLOR_INACTIVECAPTION.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_INFOBK
24
도구 설명 컨트롤의 배경색입니다. 연결된 전경색이 COLOR_INFOTEXT.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_INFOTEXT
23
도구 설명 컨트롤의 텍스트 색입니다. 연결된 배경색이 COLOR_INFOBK.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_MENU
4
메뉴 배경. 연결된 전경색이 COLOR_MENUTEXT.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_MENUHILIGHT
29
메뉴가 플랫 메뉴로 나타날 때 메뉴 항목을 강조 표시하는 데 사용되는 색입니다( SystemParametersInfo 참조). 강조 표시된 메뉴 항목은 COLOR_HIGHLIGHT 설명되어 있습니다.

Windows 2000, Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_MENUBAR
30
메뉴가 플랫 메뉴로 표시되는 경우 메뉴 모음의 배경색입니다( SystemParametersInfo 참조). 그러나 COLOR_MENU 메뉴 팝업의 배경색을 계속 지정합니다.

Windows 2000, Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_MENUTEXT
7
메뉴의 텍스트입니다. 연결된 배경색이 COLOR_MENU.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_SCROLLBAR
0
스크롤 막대 회색 영역입니다.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_WINDOW
5
창 배경. 연결된 전경색은 COLOR_WINDOWTEXT COLOR_HOTLITE.
COLOR_WINDOWFRAME
6
창 프레임.

Windows 10 이상: 이 값은 지원되지 않습니다.

COLOR_WINDOWTEXT
8
창의 텍스트입니다. 연결된 배경색이 COLOR_WINDOW.

반환 값

형식:DWORD

함수는 지정된 요소의 빨강, 녹색, 파랑(RGB) 색 값을 반환합니다.

nIndex 매개 변수가 범위를 벗어나면 반환 값은 0입니다. 0은 유효한 RGB 값이기도 하므로 GetSysColor 를 사용하여 현재 플랫폼에서 시스템 색이 지원되는지 여부를 확인할 수 없습니다. 대신 색이 지원되지 않는 경우 NULL을 반환하는 GetSysColorBrush 함수를 사용합니다.

설명

RGB 값의 구성 요소를 표시하려면 GetRValue, GetGValueGetBValue 매크로를 사용합니다.

흑백 디스플레이의 시스템 색은 일반적으로 회색 음영으로 해석됩니다.

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

Color는 대부분의 사용자 인터페이스에서 중요한 시각적 요소입니다. 애플리케이션에서 색을 사용하는 방법에 대한 지침은 색 - Win32Windows 11 색을 참조하세요.

Windows 10/11 시스템 색

이 표에는 Windows 11 수생 대비 테마의 색 값이 있는 Windows 10 및 Windows 11 지원되는 값이 나와 있습니다.

색 견본 설명

COLOR_WINDOW페이지, 창, 팝업 및 창의 배경입니다.

COLOR_WINDOWTEXT 페어링

COLOR_WINDOWTEXT제목, 본문 복사, 목록, 자리 표시자 텍스트, 앱 및 창 테두리, 상호 작용할 수 없는 모든 UI.

COLOR_WINDOW 페어링

COLOR_HOTLIGHT하이퍼링크.

COLOR_WINDOW 페어링

COLOR_GRAYTEXT비활성(사용 안 함) UI.

COLOR_WINDOW 페어링

COLOR_HIGHLIGHTTEXT선택, 상호 작용(가리키기, 누름) 또는 진행 중인 텍스트 또는 UI의 전경색입니다.

COLOR_HIGHLIGHT 페어링

COLOR_HIGHLIGHT선택, 상호 작용(가리키기, 누름) 또는 진행 중인 UI의 배경색 또는 강조 색입니다.

COLOR_HIGHLIGHTTEXT 페어링

COLOR_BTNTEXT단추 및 상호 작용할 수 있는 모든 UI의 전경색입니다.

COLOR_3DFACE 페어링

COLOR_3DFACE단추 및 상호 작용할 수 있는 모든 UI의 배경색입니다.

COLOR_BTNTEXT 페어링

이러한 이미지는 배경 집합에서 COLOR_WINDOW 사용할 때 색이 표시되는 방식을 보여 줍니다.

예제
창 텍스트 색을 사용하는 텍스트가 있는 창입니다. COLOR_WINDOWTEXT
핫 라이트 색을 사용하는 하이퍼링크 텍스트가 있는 창입니다. COLOR_HOTLIGHT
회색 텍스트 색을 사용하는 비활성 텍스트가 있는 창입니다. COLOR_GRAYTEXT
강조 색의 강조 표시 텍스트 색을 사용하는 텍스트가 있는 창입니다. COLOR_HIGHLIGHTTEXT + 강조 표시
단추 텍스트 색을 사용하는 3d 얼굴 색 및 단추 텍스트를 사용하는 단추가 있는 창입니다. COLOR_BTNTEXT + COLOR_3DFACE

예제

예제는 SetSysColors를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll

추가 정보

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo