Функция CreateSolidBrush


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

Синтаксис

HBRUSH CreateSolidBrush(
  COLORREF crColor   // код цвета кисти
);

Параметры

crColor
[in] Устанавливает цвет кисти. Чтобы создать код цвета COLORREF, используйте макрос RGB.

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

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

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL).

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Сплошная кисть - это точечный рисунок, который система использует, чтобы окрашивать внутренние части заполняемых форм.

После того, как приложение создаст кисть при помощи вызова функции CreateSolidBrush, оно может выбрать её в какой-либо контекст устройства при помощи вызова функции SelectObject.

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

Независимое управление цветом (ICM): При создании кисти цвет не создается. Однако, управление цветом выполняется тогда, когда кисть выбрана во включающий ICM контекст устройства.

Код примера

Пример, см. в статье Создание цветных перьев и кистей.

Смотри также 

Обзор Кисти, Функции, используемые кистямиCreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateDIBSection, CreateHatchBrush, CreatePatternBrush, DeleteObject, GetSysColorBrush, SelectObject, COLORREF, RGB

Размещение и совместимость CreateSolidBrush 

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz