CDC::SelectObject

Выберите объект в контекст устройства.

CPen* SelectObject(
   CPen* pPen 
);
CBrush* SelectObject(
   CBrush* pBrush 
);
virtual CFont* SelectObject(
   CFont* pFont 
);
CBitmap* SelectObject(
   CBitmap* pBitmap 
);
int SelectObject(
   CRgn* pRgn 
);
CGdiObject* SelectObject(
   CGdiObject* pObject
);

Параметры

  • pPen
    Указатель на объект CPen.

  • pBrush
    Указатель на объект CBrush.

  • pFont
    Указатель на объект CFont.

  • pBitmap
    Указатель на объект CBitmap.

  • pRgn
    Указатель на объект CRgn.

  • pObject
    Указатель на объект CGdiObject.

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

Указатель, заменяется объекту.Это указатель на объект одного из классов, производных от CGdiObject, как CPen, в зависимости от которого используется версия функции.Возвращаемое значение NULL если ошибка.Эта функция может вернуть указатель к временному объекту.Этот временный объект является допустимым только во время обработки одного сообщения Windows.Дополнительные сведения см. в разделе CGdiObject::FromHandle.

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

  • Новая вырезанная область COMPLEXREGION есть перекрывающихся границы.

  • Контекст устройства или область ERROR недопустимыми.

  • NULLREGION Новая вырезанная область пуста.

  • Новая вырезанная область SIMPLEREGION нет пересекающихся границы.

Заметки

Класс CDC предоставляет 5 специализированных версий для различных типов объектов GDI, включая пера, кисти, шрифты, растровые изображения и области.Вновь выбранный объект заменяет предыдущий объект того же типа.Например, если pObject общей версии точек SelectObject к объекту CPen функция должна заменить текущую перо с пера, указанная pObject.

Приложение может выбрать растровое изображение в контексты устройства памяти и только один контекст устройства памяти одновременно.Формат растрового изображения должен быть либо монохромным или совместимым с контекстом устройств; если это не так, то SelectObject возвращает ошибку.

Для Windows 3.1 и более поздних версиях функция SelectObject возвращает то же значение, используется ли он в метафайле.В предыдущих версиях Windows, SelectObject возвращает ненулевое значение для успешного исхода и 0 для ошибок, если он был использован в метафайле.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CGdiObject::DeleteObject

CGdiObject::FromHandle

CDC::SelectClipRgn

CDC::SelectPalette

SelectObject