Sets the bitmap or icon image to use for a control.
GUICtrlSetImage ( controlID, filename [, iconID [, icontype]] )
Parameters
| controlID | The control identifier (controlID) as returned by a GUICtrlCreate... function. |
| filename | The filename containing the picture to be display on the control. |
| iconID | [optional] Icon identifier if the file contain multiple icons. Otherwise -1. |
| icontype | [optional] To select a specific icon size : 0 = small, 1 = normal (default). for TreeViewItem the icon size : 2 = selected, 4 for nonselected item. |
Return Value
| Success: | Returns 1. |
| Failure: | Returns 0. |
Remarks
If used on a Button control the image will be displayed on the button. Images can also be set for Checkbox controls as long as the $BS_PUSHLIKE style is used. In both case the $BS_ICON or $BS_BITMAP styles are needed to select the type of the picture used.
Related
GUICtrlCreatePic, GUICtrlCreateIcon, GUICtrlCreateButton, GUICtrlCreateCheckbox
Example
#include <GUIConstants.au3>
GUICreate("My GUI") ; will create a dialog box that when displayed is centered
GUICtrlCreateButton ("my picture button", 10,20,40,40, $BS_ICON)
GUICtrlSetImage (-1, "shell32.dll",22)
GUISetState ()
; Run the GUI until the dialog is closed
While 1
$msg = GUIGetMsg()
If $msg = $GUI_EVENT_CLOSE Then ExitLoop
Wend