Поделиться через


Функция GetStockObject (wingdi.h)

Функция GetStockObject извлекает дескриптор одного из стандартных перьев, кистей, шрифтов или палитр.

Синтаксис

HGDIOBJ GetStockObject(
  [in] int i
);

Параметры

[in] i

Тип объекта stock. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
BLACK_BRUSH
Черная кисть.
DKGRAY_BRUSH
Темно-серая кисть.
DC_BRUSH
Кисть сплошного цвета. По умолчанию используется белый цвет. Цвет можно изменить с помощью функции SetDCBrushColor . Дополнительные сведения см. в разделе «Примечания».
GRAY_BRUSH
Серая кисть.
HOLLOW_BRUSH
Полая кисть (эквивалентная NULL_BRUSH).
LTGRAY_BRUSH
Светло-серая кисть.
NULL_BRUSH
Кисть null (эквивалентная HOLLOW_BRUSH).
WHITE_BRUSH
Белая кисть.
BLACK_PEN
Черная ручка.
DC_PEN
Цвет сплошного пера. Цвет по умолчанию — черный. Цвет можно изменить с помощью функции SetDCPenColor . Дополнительные сведения см. в разделе «Примечания».
NULL_PEN
Пустое перо. Пустое перо ничего не рисует.
WHITE_PEN
Белая ручка.
ANSI_FIXED_FONT
Системный шрифт Windows с фиксированным шагом (monospace).
ANSI_VAR_FONT
Системный шрифт Windows с переменным шагом (пропорциональное пространство).
DEVICE_DEFAULT_FONT
Шрифт, зависящий от устройства.
DEFAULT_GUI_FONT
Шрифт по умолчанию для объектов пользовательского интерфейса, таких как меню и диалоговые окна. Не рекомендуется использовать DEFAULT_GUI_FONT или SYSTEM_FONT для получения шрифта, используемого диалогами и окнами; Дополнительные сведения см. в разделе примечаний.

Шрифт по умолчанию — Tahoma.

OEM_FIXED_FONT
Шрифт, зависящий от изготовителя оборудования (OEM), с фиксированным шагом (monospace).
SYSTEM_FONT
Системный шрифт. По умолчанию система использует системный шрифт для рисования меню, элементов управления диалоговых окон и текста. Не рекомендуется использовать DEFAULT_GUI_FONT или SYSTEM_FONT для получения шрифта, используемого диалогами и окнами; Дополнительные сведения см. в разделе примечаний.

Системный шрифт по умолчанию — Tahoma.

SYSTEM_FIXED_FONT
Системный шрифт с фиксированным шагом (monospace). Этот стандартный объект предоставляется только для обеспечения совместимости с 16-разрядными версиями Windows до 3.0.
DEFAULT_PALETTE
Палитра по умолчанию. Эта палитра состоит из статических цветов в системной палитре.

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

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

Если функция завершается сбоем, возвращается значение NULL.

Комментарии

Не рекомендуется использовать этот метод для получения текущего шрифта, используемого диалогами и окнами. Вместо этого используйте функцию SystemParametersInfo с параметром SPI_GETNONCLIENTMETRICS, чтобы получить текущий шрифт. SystemParametersInfo учитывает текущую тему и предоставляет сведения о шрифтах для субтитров, меню и диалоговых окон сообщений.

Используйте DKGRAY_BRUSH, GRAY_BRUSH и LTGRAY_BRUSH стоковые объекты только в окнах со стилями CS_HREDRAW и CS_VREDRAW. Использование серой кисти в любом другом стиле окна может привести к неправильному смещению шаблонов кистей после перемещения или размера окна. Происхождение щеток не может быть скорректировано.

HOLLOW_BRUSH и NULL_BRUSH стоковых объектов эквивалентны.

Удалять стандартные объекты путем вызова DeleteObject не обязательно (но это не вредно).

Как DC_BRUSH, так и DC_PEN могут использоваться взаимозаменяемо с другими объектами, такими как BLACK_BRUSH и BLACK_PEN. Сведения о получении текущего цвета пера или кисти см. в разделах GetDCBrushColor и GetDCPenColor. Пример настройки цветов см. в разделе Настройка цвета пера или кисти . Функцию GetStockObject с аргументом DC_BRUSH или DC_PEN можно использовать взаимозаменяемо с функциями SetDCPenColor и SetDCBrushColor .

Примеры

Пример см. в разделе Настройка цвета пера или кисти.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

DeleteObject

Функции контекста устройства

Общие сведения о контекстах устройств

SelectObject