Функция GetSysColorBrush (winuser.h)

Статья
08/27/2023

Функция GetSysColorBrush извлекает дескриптор, определяющий логическую кисть, соответствующую указанному индексу цвета.

Синтаксис

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Параметры

[in] nIndex

Индекс цвета. Это значение соответствует цвету, используемому для рисования одного из элементов окна. Значения индекса системного цвета см. в разделе GetSysColor .

Возвращаемое значение

Возвращаемое значение определяет логическую кисть, если параметр nIndex поддерживается текущей платформой. В противном случае возвращается значение NULL.

Кисть — это растровое изображение, которое система использует для рисования внутренних элементов заполненных фигур. Приложение может получить текущие системные цвета, вызвав функцию GetSysColor . Приложение может задать текущие системные цвета, вызвав функцию SetSysColors .

Приложение не должно регистрировать класс окна для окна с помощью системной кисти. Сведения о регистрации класса окна с системным цветом см. в документации по члену hbrBackground структур WNDCLASS или WNDCLASSEX .

Системные цветовые кисти отслеживают изменения в системных цветах. Другими словами, когда пользователь изменяет системный цвет, связанная системная цветовая кисть автоматически меняется на новый цвет.

Для рисования с помощью системной цветовой кисти приложение должно использовать GetSysColorBrush (nIndex) вместо CreateSolidBrush ( GetSysColor (nIndex)), так как GetSysColorBrush возвращает кэшированную кисть вместо выделения новой.

Системные цветные кисти принадлежат системе, поэтому их не нужно уничтожать. Хотя вам не нужно удалять логическую кисть, возвращаемую GetSysColorBrush , вызов DeleteObject не повредит.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-gui-l1-1-1 (появилось в Windows 8.1)