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