Функция SetSysColors устанавливает цвета для одного или нескольких элементов изображения.Элементы изображения - различные части окна и изображения, которые система показывает на экране.
Синтаксис
BOOL SetSysColors( int cElements, // число элементов CONST INT *lpaElements, // масив элементов CONST COLORREF *lpaRgbValues // массив значений RGB ); |
Параметры
cElements
[in] Число показанных элементов в массиве lpaElements.lpaElements
[in] Указатель на массив целых чисел, которые определяют элементы изображения, которые изменятся. Список элементов изображения, см. в описании GetSysColor.lpaRgbValues
[in] Указатель на массив значений COLORREF, который содержит новые коды красного, зеленого, синего (RGB) цвета для элементов изображения в массиве, на который указывает параметр lpaElements. Чтобы создать COLORREF, используйте макрос RGB.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - ненулевое значение.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция SetSysColors отправляет сообщение WM_SYSCOLORCHANGE во все окна, чтобы информировать их о изменениях в цвете. Она также предписывает системе, чтобы перерисовать испорченные части всех текущих видимых окон.
Функция SetSysColors изменяет только текущий сеанс. Новые цвета не сохраняются, когда система завершает работу.
Код примера
Пример, см. в статье Изменение цвета элементов окна.
Смотри также
Обзор Системная информация, Функции, используемые системной информацией, GetSysColor, COLORREF, RGB
|
Размещение и совместимость SetSysColors |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |