Функция GetStockObject (wingdi.h)
Функция GetStockObject извлекает дескриптор одного из стандартных перьев, кистей, шрифтов или палитр.
Синтаксис
HGDIOBJ GetStockObject(
[in] int i
);
Параметры
[in] i
Тип объекта stock. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Черная кисть. |
|
Темно-серая кисть. |
|
Кисть сплошного цвета. По умолчанию используется белый цвет. Цвет можно изменить с помощью функции SetDCBrushColor . Дополнительные сведения см. в разделе «Примечания». |
|
Серая кисть. |
|
Полая кисть (эквивалентная NULL_BRUSH). |
|
Светло-серая кисть. |
|
Кисть null (эквивалентная HOLLOW_BRUSH). |
|
Белая кисть. |
|
Черная ручка. |
|
Цвет сплошного пера. Цвет по умолчанию — черный. Цвет можно изменить с помощью функции SetDCPenColor . Дополнительные сведения см. в разделе «Примечания». |
|
Пустое перо. Пустое перо ничего не рисует. |
|
Белая ручка. |
|
Системный шрифт Windows с фиксированным шагом (monospace). |
|
Системный шрифт Windows с переменным шагом (пропорциональное пространство). |
|
Шрифт, зависящий от устройства. |
|
Шрифт по умолчанию для объектов пользовательского интерфейса, таких как меню и диалоговые окна. Не рекомендуется использовать DEFAULT_GUI_FONT или SYSTEM_FONT для получения шрифта, используемого диалогами и окнами; Дополнительные сведения см. в разделе примечаний.
Шрифт по умолчанию — Tahoma. |
|
Шрифт, зависящий от изготовителя оборудования (OEM), с фиксированным шагом (monospace). |
|
Системный шрифт. По умолчанию система использует системный шрифт для рисования меню, элементов управления диалоговых окон и текста. Не рекомендуется использовать DEFAULT_GUI_FONT или SYSTEM_FONT для получения шрифта, используемого диалогами и окнами; Дополнительные сведения см. в разделе примечаний.
Системный шрифт по умолчанию — Tahoma. |
|
Системный шрифт с фиксированным шагом (monospace). Этот стандартный объект предоставляется только для обеспечения совместимости с 16-разрядными версиями Windows до 3.0. |
|
Палитра по умолчанию. Эта палитра состоит из статических цветов в системной палитре. |
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение является дескриптором запрошенного логического объекта.
Если функция завершается сбоем, возвращается значение 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 |