win.imageList 库模块帮助文档

win 成员列表

win.imageList()

返回对象:imageListObject

win.imageList(句柄)

通过句柄创建一个 imageList

win.imageList(宽度,高度)

创建一个 imageList

win.imageList 成员列表

图像列表，
可用于工具条、树形控件等。

图像列表默认并不会自适应 DPI 缩放（控件已实现缩放的除外），
可在窗口或控件的 onDpiChanged 事件内更换不同大小的图像列表。

建议改用 plus 控件、 win.ui.tabs 等，
这些控件可以支持适合缩放的字体图标

win.imageList.shell( SHIL )

调用SHGetImageList获取系统图像列表

win.imageList.shell()

返回对象:imageListObject

imagelistObject 成员列表

imagelistObject.add

添加图像

imagelistObject.add(图像路径,透明色)

添加图像,
成功返回自身,失败抛出异常

imagelistObject.addBitmap

添加位图

imagelistObject.addBitmap(位图句柄,透明色)

添加位图,
成功返回自身,失败抛出异常,
该函数会复制位图,不会接管或销毁传入的位图
如果传入的位图句柄不再使用,应使用::DeleteObject销毁

imagelistObject.addIcon

添加图标

imagelistObject.addIcon(图标数据)

参数可指定图标数据或文件路径,支持资源路径,
成功返回自身,失败返回null

imagelistObject.destroy()

删除对象
这个函数不会被在对象释放时被自动调用,
应用程序应在图像列表不再使用时调用此函数销毁对象，
注意treeview控件不负责自动销毁图像列表，
而listview控件在销毁时负责自动销毁正在使用的图像列表.

imagelistObject.draw(索引,hDC,x,y,fStyle)

绘图

imagelistObject.getIcon(索引,1/*_ILD_TRANSPARENT*/)

返回图标句柄
该句柄应使用 ::DestroyIcon 函数释放

imagelistObject.height

高度

imagelistObject.loadIcon(资源名,模块ID)

自图标资源载入图标,
参数@1可指定资源名或资源ID,
参数@2可省略,
成功返回自身,失败返回null

imagelistObject.width

宽度

自动完成常量

_ILC_COLOR=0
_ILC_COLOR16=0x10
_ILC_COLOR24=0x18
_ILC_COLOR32=0x20
_ILC_COLOR4=4
_ILC_COLOR8=8
_ILC_COLORDDB=0xFE
_ILC_MASK=1
_ILC_MIRROR=0x2000
_ILC_PALETTE=0x800
_ILC_PERITEMMIRROR=0x8000
_ILD_ASYNC=0x8000
_ILD_BLEND25=2
_ILD_BLEND50=4
_ILD_DPISCALE=0x4000
_ILD_IMAGE=0x20
_ILD_MASK=0x10
_ILD_NORMAL=0
_ILD_OVERLAYMASK=0xF00
_ILD_PRESERVEALPHA=0x1000
_ILD_ROP=0x40
_ILD_SCALE=0x2000
_ILD_TRANSPARENT=1
_ILS_ALPHA=8
_ILS_GLOW=1
_ILS_NORMAL=0
_ILS_SATURATE=4
_ILS_SHADOW=2
_SHIL_EXTRALARGE=2
_SHIL_JUMBO=4
_SHIL_LARGE=0
_SHIL_SMALL=1
_SHIL_SYSSMALL=3

Markdown 格式