BCM_SETIMAGELIST message

Article
06/12/2023

Affecte une liste d’images à un contrôle bouton. Vous pouvez envoyer ce message explicitement ou utiliser la macro Button_SetImageList .

Paramètres

wParam: Non utilisé ; doit être égal à zéro.
lParam: Pointeur vers une structure de BUTTON_IMAGELIST qui contient des informations de liste d’images.

Valeur retournée

Si le message réussit, il retourne TRUE. Sinon, il retourne FALSE.

Notes

Pour utiliser ce message, vous devez fournir un manifeste spécifiant Comclt32.dll version 6.0. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

La liste d’images mentionnée dans le membre himl de la structure BUTTON_IMAGELIST doit contenir une seule image à utiliser pour tous les états ou des images individuelles pour chaque état. Les états suivants sont définis dans vssym32.h.

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

Notez que PBS_STYLUSHOT est utilisé uniquement sur les tablettes.

Chaque valeur est un index de l’image appropriée dans la liste d’images. Si une seule image est présente, elle est utilisée pour tous les états. Si la liste d’images contient plusieurs images, chaque index correspond à un état du bouton. Si une image n’est pas fournie pour chaque état, rien n’est dessiné pour ces états sans images.

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]
En-tête	Commctrl.h

Partager via