SetSysColors 함수(winuser.h)
지정된 표시 요소의 색을 설정합니다. 표시 요소는 창의 다양한 부분과 시스템 디스플레이 화면에 표시되는 디스플레이입니다.
구문
BOOL SetSysColors(
[in] int cElements,
[in] const INT *lpaElements,
[in] const COLORREF *lpaRgbValues
);
매개 변수
[in] cElements
형식: int
lpaElements 배열의 표시 요소 수입니다.
[in] lpaElements
형식: const INT*
변경할 표시 요소를 지정하는 정수 배열입니다. 표시 요소 목록은 GetSysColor를 참조하세요.
[in] lpaRgbValues
형식: const COLORREF*
lpaElements 매개 변수가 가리키는 배열의 표시 요소에 대한 새 빨강, 녹색, 파랑(RGB) 색 값을 포함하는 COLORREF 값의 배열입니다.
COLORREF를 생성하려면 RGB 매크로를 사용합니다.
반환 값
형식: BOOL
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
SetSysColors 함수는 모든 창에 WM_SYSCOLORCHANGE 메시지를 보내 색의 변화를 알 수 있습니다. 또한 현재 표시되는 모든 창의 영향을 받는 부분을 다시 칠하도록 시스템에 지시합니다.
사용자가 지정한 색 설정을 준수하는 것이 가장 좋습니다. 사용자가 색을 변경할 수 있도록 애플리케이션을 작성하는 경우 이 함수를 사용하는 것이 좋습니다. 그러나 이 함수는 현재 세션에만 영향을 줍니다. 시스템이 종료되면 새 색이 저장되지 않습니다.
예제
다음 예제에서는 GetSysColor 및 SetSysColors 함수를 사용하는 방법을 보여 줍니다. 먼저 GetSysColor를 사용하여 창 배경 및 활성 캡션 색을 검색하고 16진수 표기법으로 빨강, 녹색, 파랑(RGB) 값을 표시합니다. 다음으로 SetSysColors 를 사용하여 창 배경의 색을 연한 회색으로 변경하고 활성 제목 표시줄을 진한 자주색으로 변경하는 예제입니다. 10초 지연 후 이 예제에서는 SetSysColors를 사용하여 이러한 요소에 대한 이전 색을 복원합니다.
#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")
void main()
{
int aElements[2] = {COLOR_WINDOW, COLOR_ACTIVECAPTION};
DWORD aOldColors[2];
DWORD aNewColors[2];
// Get the current color of the window background.
aOldColors[0] = GetSysColor(aElements[0]);
printf("Current window color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aOldColors[0]),
GetGValue(aOldColors[0]),
GetBValue(aOldColors[0]));
// Get the current color of the active caption.
aOldColors[1] = GetSysColor(aElements[1]);
printf("Current active caption color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aOldColors[1]),
GetGValue(aOldColors[1]),
GetBValue(aOldColors[1]));
// Define new colors for the elements
aNewColors[0] = RGB(0x80, 0x80, 0x80); // light gray
aNewColors[1] = RGB(0x80, 0x00, 0x80); // dark purple
printf("\nNew window color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aNewColors[0]),
GetGValue(aNewColors[0]),
GetBValue(aNewColors[0]));
printf("New active caption color: {0x%x, 0x%x, 0x%x}\n",
GetRValue(aNewColors[1]),
GetGValue(aNewColors[1]),
GetBValue(aNewColors[1]));
// Set the elements defined in aElements to the colors defined
// in aNewColors
SetSysColors(2, aElements, aNewColors);
printf("\nWindow background and active border have been changed.\n");
printf("Reverting to previous colors in 10 seconds...\n");
Sleep(10000);
// Restore the elements to their original colors
SetSysColors(2, aElements, aOldColors);
}
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |