Функция GetStockObject


Функция 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

Нет

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

Не имеется

 

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

Hosted by uCoz