Functions > GUI > GUICtrlUpdate >

GUICtrlSetImage

D�finit l'image bitmap ou ic�ne � utiliser pour un contr�le.

GUICtrlSetImage ( controlID, filename [, iconname [, icontype]] )

Param�tres

controlID	L'identifiant du contr�le tel que retourn� par une fonction GUICtrlCreate...(), ou -1 pour d�signer le dernier contr�le cr��.
filename	Le nom du fichier contenant l'image � afficher sur le contr�le.
iconname	[optionnel] Nom de l'ic�ne si le fichier contient plusieurs ic�nes. Peut �tre un nom ordinal si nombre n�gatif. Sinon -1.
icontype	[optionnel] Pour s�lectionner la taille d'une ic�ne sp�cifique : 0 = petite, 1 = normale (par d�faut). Pour un TreeViewItem la taille de l'ic�ne : 2 = s�lectionn�, 4 pour un item non s�lectionn�.

Valeur de retour

Succ�s:	Retourne 1.
�chec:	Retourne 0.

Remarques

Utilisez un hacker de ressources pour conna�tre la valeur du nom de l'ic�ne valide dans un fichier.

Si elle est utilis�e sur un contr�le Button, l'image sera affich�e sur le bouton. Les images peuvent �galement �tre d�finies pour des contr�les Checkbox aussi longtemps que le style $BS_PUSHLIKE est utilis�. Dans les deux cas, les styles $BS_ICON ou $BS_BITMAP sont n�cessaires pour s�lectionner le type de l'image utilis�e. La premi�re r�solution de l'ic�ne sera utilis�e dans un fichier multi ic�ne de r�solution. I.E. si 128x128 est la premi�re r�solution et le contr�le est 64x64 l'image sera tronqu�e.

!!! Si vous utilisez cette fonction sur un TreeViewItem la premi�re fois, alors tous les autres items vont utiliser cette ic�ne/image automatiquement par d�faut!!!
Si vous utilisez GUICtrlSetImage() sur un TreeView ou une ListView, tous les items de celui-ci vont adopter cette ic�ne/image.

Le passage d'un nombre positif fera r�f�rence � la cha�ne �quivalente au nom de l'ic�ne.
Le passage d'un nombre n�gatif provoquera un comportement d'index de base 1. Certaines Dll peuvent avoir une ic�ne extraite seulement avec des nombres n�gatifs.

En relation

GUICtrlCreateButton, GUICtrlCreateCheckbox, GUICtrlCreateIcon, GUICtrlCreatePic

Exemple

#include <ButtonConstants.au3>
#include <GUIConstantsEx.au3>

Example()

Func Example()
    GUICreate("My GUI") ; Cr�e une GUI centr�e

    GUICtrlCreateButton("my picture button", 10, 20, 40, 40, $BS_ICON)
    GUICtrlSetImage(-1, "shell32.dll", 22)

    GUISetState(@SW_SHOW)

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example