SelectObject 関数 (wingdi.h)

SelectObject 関数は、指定されたデバイスコンテキスト (DC) にオブジェクトを選択します。新しいオブジェクトは、同じ型の前のオブジェクトを置き換えます。

構文

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

[in] hdc

DC へのハンドル。

[in] h

選択するオブジェクトへのハンドル。指定したオブジェクトは、次のいずれかの関数を使用して作成されている必要があります。

Object	関数
Bitmap	CreateBitmap、 CreateBitmapIndirect、 CreateCompatibleBitmap、 CreateDIBitmap、 CreateDIBSection ビットマップは、メモリ DC にのみ選択できます。 1 つのビットマップを複数の DC に同時に選択することはできません。
Brush	CreateBrushIndirect、 CreateDIBPatternBrush、 CreateDIBPatternBrushPt、 CreateHatchBrush、 CreatePatternBrush、 CreateSolidBrush
フォント	CreateFont、 CreateFontIndirect
ペン	CreatePen、 CreatePenIndirect
リージョン	CombineRgn、 CreateEllipticRgn、 CreateEllipticRgnIndirect、 CreatePolygonRgn、 CreateRectRgn、 CreateRectRgnIndirect

選択したオブジェクトが領域ではなく、関数が成功した場合、戻り値は置き換えられるオブジェクトへのハンドルです。選択したオブジェクトが領域であり、関数が成功した場合、戻り値は次のいずれかの値になります。

エラーが発生し、選択したオブジェクトが領域でない場合、戻り値は NULL になります。それ以外の場合は、HGDI_ERROR。

この関数は、指定した型の以前に選択したオブジェクトを返します。アプリケーションは、新しいオブジェクトで描画を完了した後、常に新しいオブジェクトを元の既定のオブジェクトに置き換える必要があります。

アプリケーションでは、一度に複数の DC に 1 つのビットマップを選択することはできません。

Icm： 選択されているオブジェクトがブラシまたはペンの場合は、色の管理が実行されます。

例については、「ペンまたはブラシの色を設定する」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll