Function Reference

 首页  后退  前进

GUICtrlSetImage

 

设置控件的位图或图标.

 

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

参数

controlID

使用 GUICtrlCreate...() 创建控件类函数返回的控件标识符, 或使用前面创建的控件.

filename

包含图片的文件名.

iconname

[可选] 文件包含多个图标时的图标名称. 如为图标序号, 则可以是负数. 否则设为 -1.

icontype

[可选] 图标大小: 0 = 小图标, 1 = 正常(默认).

对于 TreeViewItem 则: 2 = 项目选中, 4 = 项目非选中.

返回值

成功:

返回 1.

失败:

返回 0.

备注

使用资源的程序高手都熟悉文件中的有效图标名称值.

 

如果对按钮控件使用图像, 则按钮将显示图像. 如果使用 $BS_PUSHLIKE 样式, 则复选框控件也能设置图像.

此时 $BS_ICON 或 $BS_BITMAP 样式需选择使用的图像类型. 存在多分辨率图标的文件, 控件将使用第一个图标.

如果第一个图标分辨率是 128 x 128, 而控件是 64 x 64, 图标将会被截断.

 

!!! 如果在 TreeViewItem 首次使用这个命令, 则所有项目将自动默认使用这个图标/图像 !!!

如果在 TreeView 或者 ListView 上使用本函数设置图像, 则所有项目将会换成这个图标/图像.

 

正数将引用等同于图标名称的字符串.

负数将引用以基于 1 的索引. 某些 DLL 文件只能以负数提取图标.

相关

GUICtrlCreateButton, GUICtrlCreateCheckbox, GUICtrlCreateIcon, GUICtrlCreatePic

函数示例

#include <ButtonConstants.au3>
#include <GUIConstantsEx.au3>
Example()
Func Example()
    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(@SW_SHOW)
    ; Loop until the user exits.
    While 1
        Switch GUIGetMsg()
            Case $GUI_EVENT_CLOSE
                ExitLoop
        EndSwitch
    WEnd
EndFunc   ;==>Example

----------------------------------------