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 为特定类型的GDI对象提供专用的五个版本,包括钢笔、画笔、字体、位图和区域。 新选定的对象替换相同类型的以前的对象。 例如,因此,如果 SelectObject 的泛型版本的 pObject 指向 CPen 对象,pObject替换将向当前钢笔指定的函数来用钢笔。

应用程序一次只能选择位图到仅存储设备上下文并将设置为一个单元设备上下文。 位图的格式必须是纯色或与设备上下文兼容;如果不是,SelectObject 返回false。

对于Windows 3.1和更高版本,SelectObject 函数返回相同的值是否用于图元文件。 在Windows下的早期版本中,如果在图元文件,SelectObject,返回成功的非零值和0失败的。

要求

Header: afxwin.h

请参见

参考

CDC 类

层次结构图

CGdiObject::DeleteObject

CGdiObject::FromHandle

CDC::SelectClipRgn

CDC::SelectPalette

SelectObject