ListView_SetImageList マクロ (commctrl.h)

  • [アーティクル]

リスト ビュー コントロールにイメージ リストを割り当てます。 このマクロを使用することも、 LVM_SETIMAGELIST メッセージを明示的に送信することもできます。

構文

void ListView_SetImageList(
   hwnd,
   himl,
   iImageList
);

パラメーター

hwnd

種類: HWND

リスト ビュー コントロールのハンドル。

himl

種類: HIMAGELIST

割り当てるイメージ リストへのハンドル。

iImageList

型: int

イメージ リストの種類。 このパラメーターには、次のいずれかの値を指定できます。

値 意味
LVSIL_NORMAL
 大きなアイコンを含む画像の一覧。
LVSIL_SMALL
 小さなアイコンを含む画像の一覧。
LVSIL_STATE
 状態イメージを含む画像の一覧。
LVSIL_GROUPHEADER
 グループ ヘッダーの画像一覧。

戻り値

なし

解説

LVS_SHAREIMAGELISTS スタイルが 設定されていない限り、リスト ビュー コントロールが破棄されると、現在のイメージ リストは破棄されます。 このメッセージを使用して 1 つのイメージ リストを別のイメージ リストに置き換える場合、アプリケーションは現在のイメージ リスト以外のすべてのイメージ リストを明示的に破棄する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h