SelectObject 関数 (wingdi.h)
SelectObject 関数は、指定されたデバイス コンテキスト (DC) にオブジェクトを選択します。 新しいオブジェクトは、同じ型の前のオブジェクトを置き換えます。
構文
HGDIOBJ SelectObject(
[in] HDC hdc,
[in] HGDIOBJ h
);
パラメーター
[in] hdc
DC へのハンドル。
[in] h
選択するオブジェクトへのハンドル。 指定したオブジェクトは、次のいずれかの関数を使用して作成されている必要があります。
| Object | 関数 |
|---|---|
|
CreateBitmap、 CreateBitmapIndirect、 CreateCompatibleBitmap、 CreateDIBitmap、 CreateDIBSection ビットマップは、メモリ DC にのみ選択できます。 1 つのビットマップを複数の DC に同時に選択することはできません。 |
|
CreateBrushIndirect、 CreateDIBPatternBrush、 CreateDIBPatternBrushPt、 CreateHatchBrush、 CreatePatternBrush、 CreateSolidBrush |
|
|
|
|
|
CombineRgn、 CreateEllipticRgn、 CreateEllipticRgnIndirect、 CreatePolygonRgn、 CreateRectRgn、 CreateRectRgnIndirect |
戻り値
選択したオブジェクトが領域ではなく、関数が成功した場合、戻り値は置き換えられるオブジェクトへのハンドルです。 選択したオブジェクトが領域であり、関数が成功した場合、戻り値は次のいずれかの値になります。
| 値 | 意味 |
|---|---|
| SIMPLEREGION | 領域は 1 つの四角形で構成されます。 |
| COMPLEXREGION | 領域は、複数の四角形で構成されます。 |
| NULLREGION | リージョンが空です。 |
エラーが発生し、選択したオブジェクトが領域でない場合、戻り値は NULL になります。 それ以外の場合は、HGDI_ERROR。
注釈
この関数は、指定した型の以前に選択したオブジェクトを返します。 アプリケーションは、新しいオブジェクトで描画を完了した後、常に新しいオブジェクトを元の既定のオブジェクトに置き換える必要があります。
アプリケーションでは、一度に複数の DC に 1 つのビットマップを選択することはできません。
Icm： 選択されているオブジェクトがブラシまたはペンの場合は、色の管理が実行されます。
例
例については、「 ペンまたはブラシの色を設定する」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |