Функция GetSysColorBrush извлекает дескриптор, идентифицирующий логическую кисть, которая соответствует заданному индексу цвета.
Синтаксис
HBRUSH GetSysColorBrush( int nIndex // индекс системного цвета ); |
Параметры
nIndex
[in] Устанавливает индекс цвета. Это значение соответствует цвету, используемому для окраски одного из элементов окна.Возвращаемые значения
Возвращаемое значение идентифицирует логическую кисть, если параметр nIndex поддерживается текущей платформой. В противном случае, оно возвращается как ПУСТО (NULL).
Замечания
Кисть - точечный рисунок, который система использует, чтобы окрашивать внутренние части заполняемых форм. Приложение может извлечь текущие системные цвета при помощи вызова функции GetSysColor. Прикладная программа может установить текущие системные цвета при помощи вызова функции SetSysColors.
Приложение не должно регистрировать класс окна для окна, использующее системную кисть. Чтобы зарегистрировать класс окна с системным цветом, см. описание члена hbrBackground структуры WNDCLASS или WNDCLASSEX.
Кисти системного цвета отслеживают изменения в системных цветах. Другими словами, когда пользователь изменяет системный цвет, кисть, связанная с системным цветом, автоматически изменяется на новый цвет.
Чтобы окрашивать кистью системного цвета, приложение должно использовать функцию GetSysColorBrush (nIndex) вместо CreateSolidBrush (GetSysColor (nIndex)), потому что GetSysColorBrush возвращает кэшируемую кисть вместо того, чтобы назначать новую.
Кисти системного цвета принадлежат системе и не должны разрушаться.
Смотри также
Обзор Кисти, Функции, используемые кистями, CreateSolidBrush, GetSysColor, SetSysColors, WNDCLASS, WNDCLASSEX
Размещение и совместимость GetSysColorBrush |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.51 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |