LoadBitmapA 関数 (winuser.h)

[アーティクル]
11/20/2024

[LoadBitmap は、[要件] セクションで指定したオペレーティングシステムで使用できます。以降のバージョンでは、変更または使用できない場合があります。代わりに、LoadImage を使用し、DrawFrameControlをします。

LoadBitmap 関数は、モジュールの実行可能ファイルから指定されたビットマップリソースを読み込みます。

構文

HBITMAP LoadBitmapA(
  [in] HINSTANCE hInstance,
  [in] LPCSTR    lpBitmapName
);

パラメーター

[in] hInstance

読み込むビットマップが実行可能ファイルに含まれているモジュールのインスタンスへのハンドル。

[in] lpBitmapName

読み込むビットマップリソースの名前を含む null で終わる文字列へのポインター。または、このパラメーターは、下位ワードのリソース識別子と上位ワードのゼロで構成できます。 MAKEINTRESOURCE マクロを使用して、この値を作成できます。

戻り値

関数が成功した場合、戻り値は指定されたビットマップへのハンドルです。

関数が失敗した場合、戻り値は NULL。

備考

lpBitmapName パラメーターが指すビットマップが存在しないか、ビットマップを読み込むためのメモリが不足している場合、関数は失敗します。

LoadBitmap は、プリンターで選択できない、ディスプレイの互換性のあるビットマップを作成します。選択できるビットマップをプリンターに読み込むには、LoadImage 呼び出し、DIB セクションを作成するLR_CREATEDIBSECTIONを指定します。 DIB セクションは、任意のデバイスで選択できます。

アプリケーションは、LoadBitmap 関数を使用して、定義済みのビットマップにアクセスできます。これを行うには、アプリケーションで hInstance パラメーターを NULL をし、lpBitmapName パラメーターを次のいずれかの値に設定する必要があります。

ビットマップ名	ビットマップ名
OBM_BTNCORNERS	OBM_OLD_RESTORE
OBM_BTSIZE	OBM_OLD_RGARROW
OBM_CHECK	OBM_OLD_UPARROW
OBM_CHECKBOXES	OBM_OLD_ZOOM
OBM_CLOSE	OBM_REDUCE
OBM_COMBO	OBM_REDUCED
OBM_DNARROW	OBM_RESTORE
OBM_DNARROWD	OBM_RESTORED
OBM_DNARROWI	OBM_RGARROW
OBM_LFARROW	OBM_RGARROWD
OBM_LFARROWD	OBM_RGARROWI
OBM_LFARROWI	OBM_SIZE
OBM_MNARROW	OBM_UPARROW
OBM_OLD_CLOSE	OBM_UPARROWD
OBM_OLD_DNARROW	OBM_UPARROWI
OBM_OLD_LFARROW	OBM_ZOOM
OBM_OLD_REDUCE	OBM_ZOOMD

OBM_OLDで始まるビットマップ名は、3.0 より前の Windows の 16 ビットバージョンで使用されるビットマップを表します。

アプリケーションでOBM_定数のいずれかを使用するには、Windows.h ヘッダーファイルを含める前に、定数 OEMRESOURCE を定義する必要があります。

アプリケーションは、の DeleteObject 関数を呼び出して、LoadBitmap 関数によって返される各ビットマップハンドルを削除する必要があります。

例

例については、「メニューを使用するの Menu-Item ビットマップの例」を参照してください。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LoadBitmap を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)
ライブラリ	User32.lib
DLL	User32.dll
API セットの	ext-ms-win-ntuser-draw-l1-1-1 (Windows 8.1 で導入)

次の方法で共有

LoadBitmapA 関数 (winuser.h)

構文

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース