Partager via


ImageList_SetColorTable fonction

Définit la table de couleurs pour une liste d’images.

Syntaxe

int ImageList_SetColorTable(
  _In_ HIMAGELIST himl,
  _In_ int        start,
  _In_ int        len,
  _In_ RGBQUAD    *prgb
);

Paramètres

himl [in]

Type : HIMAGELIST

Handle de la liste d’images.

démarrer [in]

Type : int

Index de table de couleurs de base zéro qui spécifie la première entrée de table de couleurs à définir.

len [in]

Type : int

Nombre d’entrées de table de couleurs à définir.

prgb [in]

Type : RGBQUAD*

Pointeur vers un tableau de structures RGBQUAD de len contenant de nouvelles informations de couleur pour la table de couleurs de la DIB.

Valeur retournée

Type : int

Si la fonction réussit, elle retourne le nombre d’entrées de table de couleurs définies par la fonction. Si la fonction échoue, la valeur de retour est inférieure ou égale à zéro.

Notes

Seules les listes d’images créées avec l’indicateur ILC_COLOR4 ou ILC_COLOR8 ont des tables de couleurs. La table de couleurs d’une telle liste d’images est généralement définie automatiquement en copiant la table de couleurs de la première image ajoutée à la liste (par exemple, via la fonction ImageList_Add ) si cette image est une DIB. Si la première image ajoutée à la liste d’images n’est pas une DIB, la table de couleurs de la palette de demi-tons est utilisée pour ILC_COLOR8 listes d’images et la table de couleurs VGA est utilisée pour ILC_COLOR4.

Spécifications

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]
DLL
Comctl32.dll (version 3.51 ou ultérieure)

Voir aussi

Tableau de couleurs