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

Статья
08/27/2023

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