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

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

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

CombineRgn

CreateBitmap

CreateBitmapIndirect

CreateBrushIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

CreateFont

CreateFontIndirect

CreateHatchBrush

CreatePatternBrush

Createpen

CreatePenIndirect

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateSolidBrush

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

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

SelectClipRgn

SelectPalette