Функция GetStockObject извлекает дескриптор одного из предопределенных (стандартных) перьев, кистей, шрифтов или палитр.
Синтаксис
HGDIOBJ GetStockObject( int fnObject // тип предопределенного объекта ); |
fnObject
[in] Устанавливает тип предопределенного объекта. Этот параметр может быть одним из ниже перечисленных значений.| Значение | Предназначение |
|---|---|
| BLACK_BRUSH | Черная кисть. |
| DKGRAY_BRUSH | Темно-серая кисть. |
| DC_BRUSH | Windows 2000/XP: Кисть сплошного тона. Цвет по умолчанию является белым. Цвет может измениться при помощи использования функция SetDCBrushColor. Подробную информацию, см. в разделе Замечаний. |
| GRAY_BRUSH | Серая кисть. |
| HOLLOW_BRUSH | Пустая кисть (эквивалент NULL_BRUSH). |
| LTGRAY_BRUSH | Светло-серая кисть. |
| NULL_BRUSH | Нулевая (пустая) кисть (эквивалент HOLLOW_BRUSH). |
| WHITE_BRUSH | Белая кисть. |
| BLACK_PEN | Черное перо. |
| DC_PEN | Windows 2000/XP: Сплошной цвет пера. Цвет по умолчанию является белым. Цвет может измениться при помощи использования функция SetDCPenColor. Подробную информацию см. в разделе Замечаний. |
| WHITE_PEN | Белое перо. |
| ANSI_FIXED_FONT | Моноширинный системный шрифт (фиксированной ширины) Windows. |
| ANSI_VAR_FONT | Системный шрифт Windows с переменным шагом (разноширинный шрифт). |
| DEVICE_DEFAULT_FONT | Windows NT/2000/XP: Аппаратно-зависимый шрифт. |
| DEFAULT_GUI_FONT | Заданный по умолчанию (типичный) шрифт для объектов пользовательского интерфейса таких как меню и диалоговые окна. Им является MS Sans Serif. Сравните это с SYSTEM_FONT. |
| OEM_FIXED_FONT | Предусматриваемый поставщиком основного оборудования (OEM) моноширинный шрифт (фиксированной ширины). |
| SYSTEM_FONT | Системный
шрифт. По умолчанию, система
использует системный шрифт, чтобы
выводить тексты меню, управляющие
элементы диалогового окна и текст.
Windows 95/98 and Windows NT: Системный шрифт - MS Sans Serif. Windows 2000/XP: Системный шрифт - Tahoma. |
| SYSTEM_FIXED_FONT | Моноширинный (фиксированной ширины) системный шрифт . Этот предопределенный (стандартный) объект предусматривается только для совместимости с 16-битовыми версиями Windows ранее чем 3.0. |
| DEFAULT_PALETTE | Заданная по умолчанию(Типичная) палитра. Эта палитра состоит из статических цветов в системной палитре. |
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор затребованного логического объекта.
Если функция завершается с ошибкой, возвращаемое значение - ПУСТО (NULL).
Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Используйте флажки DKGRAY_BRUSH, GRAY_BRUSH и объекты предопределения LTGRAY_BRUSH только в окнах со стилями CS_HREDRAW и CS_VREDRAW . Использование серой предопределенной кисти в любом другом стиле окна может привести к нарушению границ шаблонов кисти после того, как окно перемещается или изменяется по размеру. Начало координат предопределенных кистей не могут быть откорректированы.
Стандартные объекты HOLLOW_BRUSH и NULL_BRUSH эквивалентны.
Шрифт, используемый объектом предопределения DEFAULT_GUI_FONT может измениться. Используйте этот стандартный объект, когда Вы хотите использовать шрифт, который используют меню, диалоговые окна, и другие объекты пользовательского интерфейса.
Вам нет необходимости удалять предопределенные объекты при помощи вызова функции DeleteObject.
Windows 2000/XP: И DC_BRUSH и DC_PEN могут быть использованы взаимозаменяемо с другими предопределенными объектами подобно BLACK_BRUSH и BLACK_PEN. Информацию обо извлечении данных текущего пера или цвета кисти, см. в описании функций GetDCBrushColor и GetDCPenColor. В статье Установка цвета пера или кисти см. пример установки цветов. Функция GetStockObject с параметром DC_BRUSH или DC_PEN может быть использована взаимозаменяемо с функциями SetDCPenColor и SetDCBrushColor.Код примера
Пример смотри в статье Установка цвета пера или кисти.
Смотри такжеОбзор Контексты устройства, Функции, используемые контекстами устройства, DeleteObject, SelectObject
|
Размещение и совместимость GetStockObject |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |