CDC::SelectObject 

CPen * SelectObject ( CPen * pPen );

CBrush * SelectObject ( CBrush * pBrush );

Виртуальный CFont * SelectObject ( CFont * pFont );

CBitmap * SelectObject ( CBitmap * pBitmap );

int SelectObject ( CRgn * pRgn );

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

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

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

• COMPLEXREGIO&Nnbsp;  Новая область отсечения имеет перекрытия границ.
  
  
• Ошибка   Недопустимый контекст устройства или регион.
  
  
• &NULLREGIONnbsp;  Новая вырезанная область является пустым.
  
  
• SIMPLEREGIO&Nnbsp;  Новая область отсечения не имеет перекрывающихся границ.

Параметры

pPen

Указатель на объект CPen , чтобы выбрать.

pBrush

Указатель на объект CBrush , чтобы выбрать.

pFont

Указатель на объект CFont , чтобы выбрать.

pBitmap

Указатель на объект CBitmap , чтобы выбрать.

pRgn

Указатель на объект CRgn , чтобы выбрать.

Примечания

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

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

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

CDC обзор |  Члены класса | Иерархическая схема

См. такжеnbsp;CGdiObject::DeleteObject, CGdiObject::FromHandle, CDC::SelectClipRgn, CDC::SelectPalette, :: SelectObject