基 础 函 数 参 考

GUICtrlSetImage

设置控件的位图或图标.

GUICtrlSetImage ( 控件ID, 文件名 [, 图标名 [, 图标类型]] )

参 数

控件ID 由 GUICtrlCreate... 函数返回的控件标识符.
文件名 包含图片的文件名.
图标名 [可选参数] 文件包含多个图标时的图标名称. 如为图标序号, 则可以是负数. 否则设为 -1.
图标类型 [可选参数] 图标大小: 0 = 小图标, 1 = 正常(默认).
对于 TreeViewItem 则: 2 = 项目选中, 4 = 项目非选中.

返 回 值

成功: 返回 1.
失败: 返回 0.

备 注

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

如果对按钮控件使用图像, 则按钮将显示图像. 如果使用 $BS_PUSHLIKE 样式, 则复选框控件也能设置图像.
此时 $BS_ICON 或 $BS_BITMAP 样式需选择使用的图像类型. 存在多分辨率图标的文件, 控件将使用第一个图标.
如果第一个图标分辨率是 128 x 128, 而控件是 64 x 64, 图标将会被截断.

!!! 如果在 TreeViewItem 首次使用这个命令, 则所有项目将自动默认使用这个图标/图像 !!!
如果在 TreeView 或者 ListView 上使用 GUICtrlSetImage 设置图像, 则所有项目将会换成这个图标/图像.

正数将引用等同于图标名称的字符串.
负数将引用以基于 1 的索引. 某些 DLL 文件只能以负数提取图标.

相 关 函 数

GUICtrlCreatePic, GUICtrlCreateIcon, GUICtrlCreateButton, GUICtrlCreateCheckbox

函 数 示 例


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

Example()

Func Example()
    Local $msg

    GUICreate("我的 GUI") ; 创建居中显示的 GUI 窗口

    GUICtrlCreateButton("我的图片按钮", 10, 20, 40, 40, $BS_ICON)
    GUICtrlSetImage(-1, "shell32.dll", 22)

    GUISetState()

    ; 运行 GUI, 直到 GUI 被关闭
    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example

provider with jb51.net (unicode)