イメージ リスト
このセクションでは、イメージ リストで使用されるプログラミング要素について説明します。
概要
| トピック | 内容 |
|---|---|
| イメージ リスト | イメージ リストは、同じサイズのイメージのコレクションであり、各イメージはインデックスで参照できます。 |
関数
| トピック | 内容 |
|---|---|
| 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 を使用するには、マニフェストで Comctl32.dll バージョン 6 を指定します。 これを行わない場合は、Comctl32.dllバージョン 5 が既定で使用され、IImageList で予期しない動作が表示される場合があります。 マニフェストの詳細については、「ビジュアル スタイルを有効にする」を参照してください。 |
メソッド
| トピック | 内容 |
|---|---|
| [追加] | イメージまたは複数のイメージをイメージ リストに追加します。 |
| AddMasked | イメージまたは複数のイメージをイメージ リストに追加し、指定したビットマップからマスクを生成します。 |
| BeginDrag | イメージのドラッグを開始します。 |
| 複製 | 既存のイメージ リストを複製します。 |
| コピー | 特定のイメージ リストからイメージをコピーします。 |
| DragEnter | ドラッグ操作中に指定したウィンドウの更新をロックし、ウィンドウ内の指定位置にドラッグ イメージを表示します。 |
| DragLeave | 指定したウィンドウのロックを解除し、ドラッグ イメージを非表示にして、ウィンドウを更新できるようにします。 |
| DragMove | ドラッグアンドドロップ操作中にドラッグされているイメージを移動します。 この関数は通常、WM_MOUSEMOVE メッセージに応用して呼び出されます。 |
| DragShowNolock | ドラッグする画像を表示または非表示にします。 |
| Draw | 指定したデバイス コンテキストでイメージ リスト アイテムを描画します。 |
| 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::Draw 関数が使用されます。 |