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

Статья
08/27/2023

Функция SelectObject выбирает объект в указанном контексте устройства (DC). Новый объект заменяет предыдущий объект того же типа.

Синтаксис

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

Параметры

[in] hdc

Дескриптор контроллера домена.

[in] h

Дескриптор для выбранного объекта. Указанный объект должен быть создан с помощью одной из следующих функций.

Объект	Функции
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Растровые изображения можно выбрать только в контроллерах домена памяти. Одно растровое изображение не может быть выбрано в нескольких контроллерах домена одновременно.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Шрифт	CreateFont, CreateFontIndirect
Перо	CreatePen, CreatePenIndirect
Регион	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

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

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

Значение	Значение
SIMPLEREGION	Область состоит из одного прямоугольника.
COMPLEXREGION	Область состоит из нескольких прямоугольников.
NULLREGION	Область пуста.

Если возникает ошибка, а выбранный объект не является регионом, возвращается значение NULL. В противном случае это HGDI_ERROR.

Эта функция возвращает ранее выбранный объект указанного типа. Приложение всегда должно заменять новый объект исходным объектом по умолчанию после завершения рисования с новым объектом.

Приложение не может выбрать одно растровое изображение в нескольких контроллерах домена одновременно.

ICM: Если выбранный объект является кистью или пером, выполняется управление цветом.

Примеры

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

Требования

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