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 新裁剪區域有重疊的框線。
錯誤 裝置內容或區域無效。
NULLREGION 新裁剪區域是空的。
SIMPLEREGION 新裁剪區域不重疊的框線。
備註
類別 CDC 針對特定種類的 GDI 物件提供特製化的五個版本，包括字型、筆刷、畫筆、點陣圖和區域。新選取的物件取代相同型別的物件先前的。例如，如果 SelectObject ，按一般版本的 pObject 至 CPen 物件的， pObject取代這個畫筆目前指定的函式是畫筆。
應用程式一次只能選取點陣圖貼入只記憶體裝置內容和寫入記憶體裝置內容。點陣圖的格式必須為純色或與裝置內容相容;如果不是， SelectObject 傳回錯誤。
在 Windows 3.1 (含) 以後版本中， SelectObject 函式傳回相同的值是用來中繼檔。在 視窗中的舊版 Windows，當在中繼檔，請在 底下， SelectObject 成功傳回非零的值和 0 失敗。
需求
Header: afxwin.h