Функция GetSysColorBrush


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

Синтаксис

HBRUSH GetSysColorBrush(
  int nIndex  // индекс системного цвета
);

Параметры

nIndex

[in] Устанавливает индекс цвета. Это значение соответствует цвету, используемому для окраски одного из элементов окна.

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

Возвращаемое значение идентифицирует логическую кисть, если параметр nIndex поддерживается текущей платформой. В противном случае, оно возвращается как ПУСТО (NULL).

Замечания

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

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

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

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

Кисти системного цвета принадлежат системе и не должны разрушаться.

Смотри также 

Обзор Кисти, Функции, используемые кистями,  CreateSolidBrush, GetSysColor, SetSysColors, WNDCLASSWNDCLASSEX

Размещение и совместимость 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

Нет

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

Не имеется

 

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

Hosted by uCoz