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などの派生クラスで 1 種類のオブジェクトへのポインターです。戻り値はエラーがある場合 null です。この関数は、一時オブジェクトへのポインターを返す場合があります。この一時オブジェクトは Windows の 1 種類のメッセージの処理中だけです。詳細については、「CGdiObject::FromHandle」を参照してください。
領域のパラメーターを取るメンバー関数のバージョンは SelectClipRgn のメンバー関数と同じタスクを実行します。この戻り値は、次のいずれかの値:
COMPLEXREGION の新しいクリップ領域に境界線が重複することがあります。
[エラー] のデバイス コンテキストまたは領域が無効です。
NULLREGION の新しいクリップ領域は空です。
SIMPLEREGION の新しいクリップ領域の境界線に重複はありません。
解説
クラス CDC は、ペン、ブラシ、フォント、ビットマップ、領域を含む GDI オブジェクトの特定の型に特化する 5 種類のバージョンを示します。最近選択されたオブジェクトが同じ型のオブジェクトを置き換えます。たとえば、CPen のオブジェクトへの SelectObject の点のジェネリック バージョンの pObject がペンと、pObjectによって指定された関数は、現在のペンを置き換える。
アプリケーションがメモリ デバイス コンテキストのみと 1 のメモリ デバイス コンテキストだけにビットマップを一度に選択できます。ビットマップ形式はデバイス コンテキストにモノクロまたはの互換性が; そうでない場合は、SelectObject はエラーを返します。
Windows 3.1 用に、SelectObject 関数は、メタファイルに使用されるかは、同じ値を返します。Windows の以前のバージョンでは、SelectObject メタファイルに使用した場合ののゼロ以外の値と失敗した場合は 0 を返しました。
必要条件
ヘッダー: afxwin.h