Méthode IImageList ::SetImageCount (commoncontrols.h)

Redimensionne une liste d’images existante.

Syntaxe

HRESULT SetImageCount(
  [in] UINT uNewCount
);

Paramètres

[in] uNewCount

Type : UINT

Valeur qui spécifie la nouvelle taille de la liste d’images.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si une application développe une liste d’images à l’aide de cette méthode, elle doit ajouter de nouvelles images à l’aide de IImageList ::Replace. Si l’application n’ajoute pas d’images valides aux nouveaux index, les opérations de dessin qui utilisent les nouveaux index sont imprévisibles.

Si vous réduisez la taille d’une liste d’images à l’aide de cette méthode, les images à la fin de la liste pour lesquelles il n’y a plus de place sont tronquées de la liste. Les images tronquées de cette manière sont automatiquement libérées.

Pour utiliser IImageList ::SetImageCount, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commoncontrols.h
DLL	Comctl32.dll (version 6.0 ou ultérieure)