Функция SetSysColors

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz