GetStockObject 関数 (wingdi.h)
GetStockObject 関数は、いずれかのストック ペン、ブラシ、フォント、またはパレットへのハンドルを取得します。
構文
HGDIOBJ GetStockObject(
[in] int i
);
パラメーター
[in] i
ストック オブジェクトの種類。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
黒いブラシ。 |
|
濃い灰色のブラシ。 |
|
純色ブラシ。 既定の色は白です。 色は SetDCBrushColor 関数を使用して変更できます。 詳細については、「解説」を参照してください。 |
|
灰色のブラシ。 |
|
中空ブラシ(NULL_BRUSHに相当)。 |
|
薄い灰色のブラシ。 |
|
Null ブラシ (HOLLOW_BRUSHに相当)。 |
|
白いブラシ。 |
|
黒いペン。 |
|
ペンの純色。 既定の色は黒です。 色は、SetDCPenColor 関数を使用して変更できます。 詳細については、「解説」を参照してください。 |
|
Null ペン。 null ペンは何も描画しません。 |
|
白いペン。 |
|
Windows 固定ピッチ (モノスペース) システム フォント。 |
|
Windows 可変ピッチ (比例空間) システム フォント。 |
|
デバイスに依存するフォント。 |
|
メニューやダイアログ ボックスなどのユーザー インターフェイス オブジェクトの既定のフォント。 ダイアログやウィンドウで使用されるフォントを取得するには、DEFAULT_GUI_FONTまたはSYSTEM_FONTを使用することはお勧めしません。詳細については、「解説」セクションを参照してください。
既定のフォントは Tahoma です。 |
|
元の機器メーカー (OEM) 依存の固定ピッチ (モノスペース) フォント。 |
|
システム フォント。 既定では、システム フォントを使用してメニュー、ダイアログ ボックス コントロール、テキストを描画します。 ダイアログやウィンドウで使用されるフォントを取得するには、DEFAULT_GUI_FONTまたはSYSTEM_FONTを使用することはお勧めしません。詳細については、「解説」セクションを参照してください。
既定のシステム フォントは Tahoma です。 |
|
固定ピッチ (モノスペース) システム フォント。 このストック オブジェクトは、3.0 より前の 16 ビット Windows バージョンとの互換性を確保するためにのみ提供されます。 |
|
既定のパレット。 このパレットは、システム パレットの静的な色で構成されます。 |
戻り値
関数が成功した場合、戻り値は要求された論理オブジェクトへのハンドルです。
関数が失敗した場合は、返される値は NULL です。
解説
ダイアログとウィンドウで使用されている現在のフォントを取得するには、このメソッドを使用しないことをお勧めします。 代わりに、 systemParametersInfo 関数を SPI_GETNONCLIENTMETRICS パラメーターと共に使用して、現在のフォントを取得します。 SystemParametersInfo では、現在のテーマが考慮され、キャプション、メニュー、メッセージ ダイアログのフォント情報が提供されます。
DKGRAY_BRUSH、GRAY_BRUSH、およびLTGRAY_BRUSHストック オブジェクトは、CS_HREDRAWスタイルとCS_VREDRAWスタイルを持つウィンドウでのみ使用します。 他のスタイルのウィンドウで灰色のストック ブラシを使用すると、ウィンドウを移動またはサイズ変更した後にブラシ パターンの位置がずれる可能性があります。 ストック ブラシの原点は調整できません。
HOLLOW_BRUSHとNULL_BRUSHストック オブジェクトは同等です。
DeleteObject を呼び出してストック オブジェクトを削除する必要はありません (ただし有害ではありません)。
DC_BRUSHとDC_PENの両方を、BLACK_BRUSHやBLACK_PENなどの他のストック オブジェクトと同じ意味で使用できます。 現在のペンまたはブラシの色を取得する方法については、「 GetDCBrushColor 」および「 GetDCPenColor」を参照してください。 色 の設定例については、「ペンまたはブラシの色 を設定する」を参照してください。 DC_BRUSH または DC_PEN の引数を持つ GetStockObject 関数は、 SetDCPenColor 関数および SetDCBrushColor 関数と同じ意味で使用できます。
例
例については、「 ペンまたはブラシの色を設定する」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |