Win32 API Reference

GetSysColor

원형

DWORD GetSysColor(int nIndex);

MFC 원형

해당하는 함수 없음

인수

▶nIndex : 구하고자 하는 시스템 색상이며 다음 요소 중 하나를 지정해 주어야 한다.

nIndex	설명
COLOR_3DDKSHADOW	3차원 요소의 어두운 그림자 색상
COLOR_3DFACE, COLOR_BTNFACE	대화상자의 배경색상
COLOR_3DHILIGHT, COLOR_3DHIGHLIGHT, COLOR_BTNHILIGHT, COLOR_BTNHIGHLIGHT	삼차원 요소의 밝은 부분
COLOR_3DLIGHT	삼차원 요소의 밝은 부분
COLOR_3DSHADOW, COLOR_BTNSHADOW	삼차원 요소의 그림자 색상
COLOR_ACTIVEBORDER	액티브된 윈도우의 경계선 색상
COLOR_ACTIVECAPTION	액티브된 윈도우의 타이틀 바 색상. 타이틀 바에 그라디언트가 들어갈 경우 왼쪽 부분의 색상이다.
COLOR_APPWORKSPACE	MDI 윈도우의 배경 색상
COLOR_BACKGROUND, COLOR_DESKTOP	데스크 탑
COLOR_BTNTEXT	버튼의 텍스트
COLOR_CAPTIONTEXT	캡션, 크기 조절 박스, 스크롤 바의 화살표 박스
COLOR_GRADIENTACTIVECAPTION	타이틀 바에 그라디언트가 들어갈 경우 오른쪽 부분의 색상이며 98 ME 이하에서는 지원되지 않는다.
COLOR_GRADIENTINACTIVECAPTION	타이틀 바에 그라디언트가 들어갈 경우 액티브되지 않은 윈도우의 오른쪽 부분의 색상이며 98 ME 이하에서는 지원되지 않는다.
COLOR_GRAYTEXT	사용 금지된 컨트롤의 텍스트
COLOR_HIGHLIGHT	컨트롤의 선택된 항목의 색상
COLOR_HIGHLIGHTTEXT	컨트롤의 선택된 항목의 텍스트 색상
COLOR_HOTLIGHT	ME 이상. 핫 트랙 항목의 색상
COLOR_INACTIVEBORDER	액티브되지 않은 윈도우의 경계선
COLOR_INACTIVECAPTION	액티브되지 않은 윈도우의 타이블 바 색상. 타이틀 바에 그라디언트가 들어갈 경우 왼쪽 부분의 색상이다.
COLOR_INACTIVECAPTIONTEXT	액티브되지 않은 윈도우의 텍스트 색상
COLOR_INFOBK	툴팁 컨트롤의 배경색상
COLOR_INFOTEXT	툴팁 컨트롤의 텍스트 색상
COLOR_MENU	메뉴의 배경 색상
COLOR_MENUHILIGHT	XP이상. Flat 메뉴의 강조 메뉴 항목 색상
COLOR_MENUBAR	XP이상. Flat 메뉴의 배경 색상
COLOR_MENUTEXT	메뉴의 텍스트
COLOR_SCROLLBAR	스크롤바의 색상
COLOR_WINDOW	윈도우의 배경색
COLOR_WINDOWFRAME	윈도우 프레임
COLOR_WINDOWTEXT	윈도우의 텍스트 색상

리턴

요청한 시스템 색상을 구한다. 이 값은 빨강, 초록, 파랑색 요소로 구성된 COLORREF값이다. nIndex가 무효한 값일 경우는 0을 리턴하는데 이는 검정색이 아니라 지원하지 않는 시스템 색상이라는 뜻이다. 시스템 색상이 검정인지, 지원하는 색상이 아닌지는 GetSysColorBrush 함수로 조사할 수 있다.

설명

시스템 색상이란 운영체제에 등록되어 있는 색상이며 운영체제는 시스템 색상표에 등록되어 있는 색상대로 윈도우와 그 구성요소를 그린다. 시스템 색상은 바탕화면의 등록 정보에서 사용자가 직접 변경할 수 있으며 응용 프로그램은 사용자가 설정해 놓은 시스템 색상을 조사하여 설정된 대로 윈도우의 구성 요소를 그려야 한다. 타이틀 바는 항상 파란색이 아니며 사용자에 의해 다른 색상으로 변경될 수도 있기 때문이다.

예제 1

다음 예제는 데스크 탑과 동일한 색상으로 텍스트를 출력한다.

LRESULT CALLBACK WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
	HDC hdc;
	PAINTSTRUCT ps;
	COLORREF Color;
	char Mes[]="데스크탑과 항상 같은 색상이다";

	switch(iMessage) {
	case WM_PAINT:
		hdc=BeginPaint(hWnd, &ps);
		Color=GetSysColor(COLOR_DESKTOP);
		SetTextColor(hdc,Color);
		TextOut(hdc,10,10,Mes,lstrlen(Mes));
		EndPaint(hWnd, &ps);
		return 0;
	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	}
	return(DefWindowProc(hWnd,iMessage,wParam,lParam));
}

데스크 탑 색상은 사용자가 마음대로 변경할 수 있는 색상이므로 반드시 GetSysColor로 색상을 조사해야만 정확한 값을 알 수 있다. 실행중의 모습은 다음과 같다.

데스크 탑의 색상이 검정색이므로 텍스트도 검정색으로 출력되었다. 바탕화면 등록정보에서 데스크탑의 색상을 변경하면 이 텍스트의 색상도 같이 변경된다.

참고함수

SetSysColor, GetSysColorBrush

플랫폼

95이상

참조

written by http://www.winapi.co.kr