Функция GetSysColorBrush (winuser.h)
Функция 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) |