次の方法で共有

イメージ リスト

  • [アーティクル]

このセクションには、画像リストで使用されるプログラミング要素に関する情報が含まれています。

概要

話題 内容
イメージ リストの イメージ リストは、同じサイズのイメージのコレクションであり、それぞれのイメージのインデックスで参照できます。

関数

話題 内容
HIMAGELIST_QueryInterface イメージ リストの HIMAGELIST ハンドルに対応する IImageList または IImageList2オブジェクトへのポインターを取得します。
ImageList_Add イメージまたはイメージをイメージ リストに追加します。
ImageList_AddMasked イメージまたはイメージをイメージ リストに追加し、指定したビットマップからマスクを生成します。
ImageList_BeginDrag イメージのドラッグを開始します。
ImageList_CoCreateInstance イメージリストの 1 つのインスタンスを作成し、そのインスタンスへのインターフェイス ポインターを返します。
ImageList_Copy 特定のイメージ リスト内のイメージをコピーします。
ImageList_Create 新しいイメージ リストを作成します。
ImageList_Destroy イメージ リストを破棄します。
ImageList_DragEnter ウィンドウ内の指定した位置にドラッグ画像を表示します。
ImageList_DragLeave 指定したウィンドウのロックを解除し、ドラッグイメージを非表示にして、ウィンドウを更新できるようにします。
ImageList_DragMove ドラッグ アンド ドロップ操作中にドラッグされているイメージを移動します。 この関数は通常、WM_MOUSEMOVE メッセージに応答して呼び出されます。
ImageList_DragShowNolock ドラッグする画像を表示または非表示にします。
ImageList_Draw 指定したデバイス コンテキストでイメージ リスト 項目を描画します。
ImageList_DrawEx 指定したデバイス コンテキストでイメージ リスト 項目を描画します。 この関数は、指定した描画スタイルを使用し、指定した色でイメージをブレンドします。
ImageList_DrawIndirect IMAGELISTDRAWPARAMS 構造体に基づいてイメージ リスト イメージを描画します。
ImageList_Duplicate 既存のイメージ リストの複製を作成します。
ImageList_EndDrag ドラッグ操作を終了します。
ImageList_GetBkColor イメージ リストの現在の背景色を取得します。
ImageList_GetDragImage ドラッグイメージに使用される一時イメージリストを取得します。 また、この関数は、ドラッグ位置に対する現在のドラッグ位置とドラッグ画像のオフセットも取得します。
ImageList_GetIcon イメージからアイコンを作成し、イメージ リストでマスクします。
ImageList_GetIconSize イメージ リスト内の画像の寸法を取得します。 イメージ リスト内のすべての画像は同じディメンションを持っています。
ImageList_GetImageCount イメージ リスト内のイメージの数を取得します。
ImageList_GetImageInfo イメージに関する情報を取得します。
ImageList_LoadImage 指定したビットマップからイメージ リストを作成します。
ImageList_Merge 既存の 2 つのイメージを組み合わせて新しいイメージを作成します。 この関数では、イメージを格納する新しいイメージ リストも作成されます。
ImageList_Read ストリームからイメージ リストを読み取ります。
ImageList_ReadEx ストリームからイメージ リストを読み取り、イメージ リストにインターフェイスを返します。
ImageList_Remove イメージリストからイメージを削除します。
ImageList_Replace イメージ リスト内のイメージを新しいイメージに置き換えます。
ImageList_ReplaceIcon イメージをアイコンまたはカーソルに置き換えます。
ImageList_SetBkColor イメージ リストの背景色を設定します。 この関数は、アイコンを追加するか、白黒ビットマップで ImageList_AddMasked を使用する場合にのみ機能します。 マスクがないと、画像全体が描画されます。そのため、背景色は表示されません。
ImageList_SetColorTable イメージ リストのカラー テーブルを設定します。
ImageList_SetDragCursorImage 指定したイメージ (通常はマウス カーソルイメージ) と現在のドラッグイメージを組み合わせて、新しいドラッグイメージを作成します。
ImageList_SetIconSize イメージ リスト内のイメージの寸法を設定し、リストからすべてのイメージを削除します。
ImageList_SetImageCount 既存のイメージ リストのサイズを変更します。
ImageList_SetOverlayImage オーバーレイ マスクとして使用するイメージの一覧に、指定したイメージを追加します。 イメージ リストには、バージョン 4.70 以前では最大 4 個、バージョン 4.71 では最大 15 個のオーバーレイ マスクを使用できます。 この関数は、指定されたイメージにオーバーレイ マスク インデックスを割り当てます。
ImageList_Write イメージ リストをストリームに書き込みます。
ImageList_WriteEx イメージ リストをストリームに書き込みます。

マクロ

話題 内容
ImageList_AddIcon イメージ リストにアイコンまたはカーソルを追加します。 ImageList_AddIcon は、ImageList_ReplaceIcon 関数を呼び出します。
ImageList_ExtractIcon ImageList_GetIcon 関数を呼び出して、イメージに基づいてアイコンまたはカーソルを作成し、イメージ リストにマスクします。
ImageList_LoadBitmap ImageList_LoadImage 関数を呼び出して、指定したビットマップ リソースからイメージ リストを作成します。
ImageList_RemoveAll ImageList_Remove 関数を呼び出して、イメージ リストからすべてのイメージを削除します。
INDEXTOOVERLAYMASKの ImageList_Draw 関数で使用できるように、オーバーレイ マスクのインデックスを準備します。

インターフェイス

話題 内容
IImageListをする イメージ リストを操作および操作するメソッドを公開します。
IImageList使用するには、マニフェストでバージョン 6 Comctl32.dll 指定します。 これを行わない場合、Comctl32.dll バージョン 5 が既定で使用され、IImageList 予期しない動作が表示される可能性があります。 マニフェストの詳細については、「Visual Stylesを有効にする」を参照してください。

メソッド

話題 内容
の追加 イメージまたはイメージをイメージ リストに追加します。
AddMaskedの イメージまたはイメージをイメージ リストに追加し、指定したビットマップからマスクを生成します。
BeginDragの イメージのドラッグを開始します。
クローン 既存のイメージ リストを複製します。
のコピー 特定のイメージ リストからイメージをコピーします。
DragEnter ドラッグ操作中に指定したウィンドウの更新をロックし、ウィンドウ内の指定した位置にドラッグ イメージを表示します。
DragLeave 指定したウィンドウのロックを解除し、ドラッグイメージを非表示にして、ウィンドウを更新できるようにします。
DragMove ドラッグ アンド ドロップ操作中にドラッグされているイメージを移動します。 この関数は通常、WM_MOUSEMOVE メッセージに応答して呼び出されます。
DragShowNolock ドラッグする画像を表示または非表示にします。
描画 指定したデバイス コンテキストでイメージ リスト 項目を描画します。
EndDragをする ドラッグ操作を終了します。
GetBkColorをする イメージ リストの現在の背景色を取得します。
GetDragImageの ドラッグイメージに使用される一時イメージリストを取得します。 また、この関数は、ドラッグ位置に対する現在のドラッグ位置とドラッグ画像のオフセットも取得します。
GetIconの イメージからアイコンを作成し、イメージ リストにマスクを作成します。
GetIconSizeの イメージ リスト内のイメージのサイズを取得します。 イメージ リスト内のすべての画像は同じディメンションを持っています。
GetImageCountの イメージ リスト内のイメージの数を取得します。
GetImageInfoをする イメージに関する情報を取得します。
GetImageRectの イメージの外接する四角形を取得します。
GetItemFlagsの イメージのフラグを取得します。
GetOverlayImageをする オーバーレイ マスクとして使用されるイメージの一覧から、指定したイメージを取得します。
マージ 既存の 2 つのイメージを組み合わせて新しいイメージを作成します。 このメソッドは、イメージを格納する新しいイメージ リストも作成します。
削除 イメージリストからイメージを削除します。
置換 イメージ リスト内のイメージを新しいイメージに置き換えます。
ReplaceIcon イメージをアイコンまたはカーソルに置き換えます。
SetBkColor イメージ リストの背景色を設定します。 このメソッドは、イメージ リストにアイコンを追加する場合、または IImageList::AddMasked メソッドを使用して白黒ビットマップを追加する場合にのみ機能します。 マスクがないと、イメージ全体が描画され、背景色は表示されません。
SetDragCursorImageの 指定したイメージ (通常はマウス カーソルイメージ) と現在のドラッグイメージを組み合わせて、新しいドラッグイメージを作成します。
SetIconSize イメージ リスト内のイメージの寸法を設定し、リストからすべてのイメージを削除します。
SetImageCountの 既存のイメージ リストのサイズを変更します。
SetOverlayImageの オーバーレイ マスクとして使用されるイメージの一覧に、指定したイメージを追加します。 Common Controls バージョン 4.70 以前では 4 つ、バージョン 4.71 以降では最大 15 個のオーバーレイ マスクをイメージ リストに含めることができます。 このメソッドは、指定されたイメージにオーバーレイ マスク インデックスを割り当てます。

構造

話題 内容
IMAGEINFO イメージ リスト内のイメージに関する情報が含まれています。 この構造体は、IImageList::GetImageInfo 関数と共に使用されます。
IMAGELISTDRAWPARAMSの イメージ リスト描画操作に関する情報が含まれており、IImageList::D raw 関数で使用されます。