IImageList::SetImageCount メソッド (commoncontrols.h)

既存のイメージリストのサイズを変更します。

構文

HRESULT SetImageCount(
  [in] UINT uNewCount
);

[in] uNewCount

型: UINT

イメージリストの新しいサイズを示す値です。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

アプリケーションがこのメソッドを使用してイメージリストを展開する場合は、 IImageList::Replace を使用して新しいイメージを追加する必要があります。アプリケーションが新しいインデックスに有効なイメージを追加しない場合、新しいインデックスを使用する描画操作は予測できません。

このメソッドを使用して画像リストのサイズを小さくすると、リストの末尾にスペースがなくなった画像がリストから切り捨てられます。この方法で切り捨てられたイメージは自動的に割り当て解除されます。

IImageList::SetImageCount を使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。マニフェストの詳細については、「ビジュアルスタイルの有効化」を参照してください。