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

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

構文

HRESULT SetImageCount(
  [in] UINT uNewCount
);

パラメーター

[in] uNewCount

型: UINT

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

戻り値

型: HRESULT

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

注釈

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

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

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

要件