macro TreeView_SetImageList (commctrl.h)

  • Article

Définit la liste d’images normale ou d’état pour un contrôle d’arborescence et redessine le contrôle à l’aide des nouvelles images. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETIMAGELIST.

Syntaxe

HIMAGELIST TreeView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   INT        iImage
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

himl

Type : HIMAGELIST

Handle HIMAGELIST dans la liste d’images. Si luil est NULL, le message supprime la liste d’images spécifiée du contrôle d’arborescence.

iImage

Type : INT

Type de liste d’images à définir. Ce paramètre peut être l’une des valeurs suivantes :

Valeur Signification
TVSIL_NORMAL
 Indique la liste d’images normale, qui contient des images sélectionnées, non sélectionnées et superposées pour les éléments d’un contrôle d’arborescence.
TVSIL_STATE
 Indique la liste d’images d’état. Vous pouvez utiliser des images d’état pour indiquer les états d’élément définis par l’application. Une image d’état s’affiche à gauche de l’image sélectionnée ou non sélectionnée d’un élément.

Valeur de retour

Type : HIMAGELIST

Retourne le handle HIMAGELIST à la liste d’images précédente, le cas échéant, ou NULL.

Remarques

Le contrôle d’arborescence ne détruit pas la liste d’images spécifiée avec ce message. Votre application doit détruire la liste d’images lorsqu’elle n’est plus nécessaire.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête commctrl.h

Voir aussi

de référence

TVM_GETIMAGELIST

TreeView_GetImageList