次の方法で共有

ImageList_LoadImageW関数 (commctrl.h)

  • [アーティクル]

指定したビットマップからイメージ リストを作成します。

構文

HIMAGELIST ImageList_LoadImageW(
  HINSTANCE hi,
  LPCWSTR   lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

パラメーター

hi

型: HINSTANCE

リソースを含むインスタンスへのハンドル。 ファイルからイメージを読み込む場合、または OEM リソースを読み込む場合、このパラメーターは NULL を できます。

lpbmp

型: LPCTSTR

読み込むイメージ。

uFlags パラメーターにLR_LOADFROMFILEが含まれている場合、lpbmp は、読み込むイメージを含むファイルに名前を付ける null で終わる文字列のアドレスです。

hi パラメーターが null指定されておらず、LR_LOADFROMFILEが指定されていない場合、lpbmp は、hi モジュール内のイメージ リソースの名前を含む null で終わる文字列のアドレスです。

hi が NULL であり、LR_LOADFROMFILEが指定されていない場合、このパラメーターの LOWORD は、読み込む OEM イメージの識別子である必要があります。 この値を作成するには、winuser.h で定義されている OEM イメージ識別子の 1 つで MAKEINTRESOURCE マクロを使用します。 これらの識別子には、次のプレフィックスがあります。

価値 意味
OEM ビットマップ の OBM_
OEM アイコン の OIC_
OEM カーソル の OCR_

cx

型: int

各イメージの幅。 各イメージの高さと画像の初期数は、指定されたリソースのディメンションによって推論されます。

cGrow

型: int

システムが新しいイメージ用の領域を作成する必要があるときに、イメージ リストを拡大できるイメージの数。 このパラメーターは、サイズ変更されたイメージ リストに含めることができる新しいイメージの数を表します。

crMask

型: COLORREF

マスクの生成に使用される色。 指定したビットマップ、カーソル、またはアイコン内のこの色の各ピクセルが黒に変更され、マスク内の対応するビットが 1 に設定されます。 このパラメーターがCLR_NONE値の場合、マスクは生成されません。 このパラメーターがCLR_DEFAULT値の場合、画像の左上隅にあるピクセルの色はマスクの色として扱われます。

uType

型: UINT

読み込むイメージの種類を指定するフラグ。 ビットマップが読み込まれていることを示すには、このパラメーターをIMAGE_BITMAPする必要があります。

注ImageList_LoadImage はビットマップ ファイルでのみ使用されます。 他のイメージの種類はサポートされていません。
 
価値 意味
IMAGE_BITMAP
 ビットマップを読み込みます。

uFlags

型: UINT

イメージの読み込み方法を指定するフラグ。 このパラメーターには、次の値の組み合わせを指定できます。

価値 意味
LR_CREATEDIBSECTION
 uType パラメーターがIMAGE_BITMAPを指定するときに、互換性のあるビットマップではなく、DIB セクションビットマップを返します。 LR_CREATEDIBSECTIONは、ビットマップをディスプレイ デバイスの色にマッピングせずに読み込む場合に便利です。
LR_DEFAULTCOLOR
 ディスプレイの色形式を使用します。
LR_DEFAULTSIZE
 cx パラメーターが 0 に設定されている場合は、カーソルとアイコンのシステム メトリック値で指定された幅または高さを使用します。 この値が指定されておらず、cx 0 に設定されている場合、関数はリソースで指定されたサイズにサイズを設定します。 リソースに複数のイメージが含まれている場合、関数は最初のイメージのサイズを設定します。
LR_LOADFROMFILE
 lpbmp パラメーターで指定されたファイルからイメージを読み込みます。
LR_LOADMAP3DCOLORS
 カラー テーブルで画像を検索し、次の灰色の濃淡を対応する 3 次元の色に置き換えます。

Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW

灰色: RGB(192, 192, 192)COLOR_3DFACE

Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT

詳細については、「解説」セクションを参照してください。
LR_LOADTRANSPARENT
 画像の最初のピクセルの色値を取得し、カラー テーブル内の対応するエントリを既定のウィンドウの色 (COLOR_WINDOW表示色) に置き換えます。 その色を使用するイメージ内のすべてのピクセルが、既定のウィンドウ値の色になります。 この値は、対応するカラー テーブルを持つイメージにのみ適用されます。 詳細については、「解説」セクションを参照してください。
LR_MONOCHROME
 イメージを白黒で読み込みます。
LR_SHARED
 イメージが複数回読み込まれる場合は、イメージ ハンドルを共有します。 この値は、読み込み後に変更される可能性がある非パーティション サイズのイメージや、ファイルから読み込まれるイメージには使用しないでください。

戻り値

型: HIMAGELIST

成功した場合はイメージ リストにハンドルを返し、それ以外の場合は NULL します。

備考

LR_LOADTRANSPARENTでは、イメージが透過的に読み込まれません。 すべての背景ピクセルがCOLOR_WINDOWに変更されたため、透明に見えるだけの不透明なイメージ リストが作成されます。 COLOR_WINDOW色ではない背景にイメージが描画されている場合、イメージは正しく描画されません。 また、LR_LOADTRANSPARENTとLR_LOADMAP3DCOLORSは、ImageList_LoadImage が呼び出された時点で有効だったシステム の色を使用します。 システムの色が変更された場合、アプリケーションはイメージを再読み込みして色を再マップする必要があります。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h
ライブラリ Comctl32.lib
DLL Comctl32.dll

関連項目

LoadImage の