aardio 文档

win.ui.toolbar 库模块帮助文档

toolbarButtonObject 成员列表 #

toolbarButtonObject.checked #

是否选中

toolbarButtonObject.click() #

点击按钮

toolbarButtonObject.delete() #

删除按钮

toolbarButtonObject.disabled #

是否禁用

toolbarButtonObject.getInfo( _TBIF ) #

获取TBBUTTONINFO结构体

toolbarButtonObject.getRect() #

返回按钮区块

返回对象:rectObject

toolbarButtonObject.id #

命令ID

toolbarButtonObject.index() #

返回按钮索引

toolbarButtonObject.setInfo( ) #

设置TBBUTTONINFO结构体,可指定部分字段

toolbarButtonObject.state #

读写按钮状态

toolbarButtonObject.text #

按钮文本

toolbarObject 成员列表 #

toolbarObject.add() #

添加一个分隔条

返回对象:toolbarButtonObject

toolbarObject.add(标题,回调函数,图像索引,可选指定命令ID) #

toolbarObject.add(  
    "文字",   
    function (id) {  

    },1  
)

toolbarObject.adjust() #

重新设置工具栏大小

toolbarObject.bottom #

底部坐标。
只能获取,修改无效

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.buttons[1索引] #

返回指定的按钮对象

toolbarObject.capture #

是否捕获全局鼠标消息

toolbarObject.className #

运行时类名

toolbarObject.cls #

设计时类名

toolbarObject.create(tParam) #

创建工具条,注意工具条会占用父窗口上的空间,
可选传入 @tParam 参数表,可包含 style,exstyle 等样式参数
可用样式可参考:
https://docs.microsoft.com/en-us/windows/win32/controls/toolbar-control-and-button-styles

toolbarObject.disabled #

是否禁用

toolbarObject.getButton() #

返回对象:toolbarButtonObject

toolbarObject.getButton(索引) #

返回按钮对象

toolbarObject.getButtonById() #

返回对象:toolbarButtonObject

toolbarObject.getButtonById(idCommand) #

返回按钮对象

toolbarObject.getClientRect() #

控件客户区块位置,返回值为 ::RECT结构体

返回对象:rectObject

toolbarObject.getExtended() #

获取工具条扩展样式

toolbarObject.getExtended(exstyle) #

获取工具条指定扩展样式

toolbarObject.getFont(true) #

返回控件字体,返回值为 ::LOGFONT 结构体

返回对象:logfontObject

toolbarObject.getForm() #

标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。
win.form 创建的窗体对象返回自身,其他控件对象返回创建控件的容器窗口( _parentForm 属性 )。

toolbarObject.getNotifyInfo(ptr) #

在通知回调中获取 PNMTOOLBAR 结构体,
ptr 为 onnotify 回调传过来的指针参数

toolbarObject.getParent() #

返回父窗口

返回对象:winform

toolbarObject.getPos() #

返回相对父窗口客户区的坐标,宽,高,
参数为 true 返回屏幕坐标,宽,高

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.getRect() #

控件区块位置,返回值为 ::RECT结构体

返回对象:rectObject

toolbarObject.getRect(true) #

控件屏幕区块位置,返回值为 ::RECT结构体

toolbarObject.getRoot() #

获取顶层父窗口

toolbarObject.height #

获取时返回工具条实际高度。
只能获取,修改无效。

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.hide #

控件是否隐藏

toolbarObject.hwnd #

控件句柄

toolbarObject.imageList #

指定工具条控件的图像列表。
指定的图像列表支持 DPI 自适应缩放
发送 _CCM_DPISCALE 消息且其他参数为 0 可关闭 DPI 自适应

toolbarObject.left #

左侧坐标。
只能获取,修改无效

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.modifyStyle(移除样式,添加样式) #

所有参数可选,默认为0
使用 TBSTYLE 前缀常量表示样式

toolbarObject.onDestroy #

toolbarObject.onDestroy = function(){  
    /*窗口销毁前触发*/  
}

toolbarObject.onnotify #

toolbarObject.onnotify = function(id,code,ptr){  
    /*通知事件触发*/  
}

toolbarObject.postMessage(msg,wParam,lParam) #

投递窗口消息到消息队列中
此函数用法请参考 ::User32.PostMessage

toolbarObject.redraw() #

刷新

toolbarObject.redrawTransparent() #

刷新
透明背景时请使用此函数替代redraw()

toolbarObject.right #

右侧坐标。
只能获取,修改无效

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.sendMessage(msg,wParam,lParam) #

发送窗口消息
此函数用法请参考 ::User32.SendMessage

toolbarObject.setExtended(exstyle) #

启用工具条指定扩展样式

toolbarObject.setExtended(exstyle,false) #

取消工具条指定扩展样式

toolbarObject.setFont(指定字体) #

指定LOGFONT字体对象,或逻辑字体句柄

toolbarObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) #

调整窗口位置或排序,所有参数可选
同时指定x,y坐标则移动位置
同时指定宽高则改变大小
指定插入位置(句柄或_HWND前缀常量)则调整Z序

toolbarObject.setRect(rc) #

设置控件区块位置,返回值为 ::RECT结构体

toolbarObject.setRect(rc,true) #

设置控件屏幕区块位置,返回值为 ::RECT结构体

toolbarObject.setRedraw(false) #

禁止重绘

toolbarObject.setRedraw(true) #

恢复重绘

toolbarObject.show(true) #

显示控件

toolbarObject.showLabel #

是否在按钮上显示文字

toolbarObject.style #

工具栏样式,数值,
使用 TBSTYLE 前缀常量表示样式,
也支持 CCS 前缀的样式常量,
直接设置此样式会覆盖工具条原来的一些默认样式,
例如 让工具条显示在顶部的 _CCS_TOP,这会导致工具条移到底部,
建议用 modifyStyle 修改样式可避免此问题

toolbarObject.theme #

外观主题,例如
winform.button.theme = "Explorer"
winform.button.theme = false

toolbarObject.top #

顶部坐标。
只能获取,修改无效

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.width #

工具条宽度。
只能获取,修改无效

注意工具条是默认已经做过 DPI 缩放的,
所以请在 winform.enableDpiScaling("init"); 以后使用这些属性

toolbarObject.wndproc #

toolbarObject.wndproc = function(hwnd,message,wParam,lParam){  
    /*窗口消息回调,返回任意非null值阻止默认回调  
wndproc重复赋值时追加函数而不是覆盖之前的回调  
设为null添除所有消息回调函数  
wndproc也可以是一个表,键要为处理的消息,值为对应的消息回调函数*/     
}

toolbarObject.buttons 成员列表 #

toolbarObject.buttons.* #

返回对象:toolbarButtonObject

win.ui 成员列表 #

win.ui.toolbar() #

返回对象:toolbarObject

win.ui.toolbar(父窗口) #

工具条控件。

此控件不建议使用,请改用高级选项( win.ui.tabs ),
高级选项卡可以更好地支持字体图标、 DPI 缩放等

自动完成常量

_CCS_ADJUSTABLE=0x20
_CCS_BOTTOM=3
_CCS_LEFT=0x81
_CCS_NODIVIDER=0x40
_CCS_NOMOVEX=0x82
_CCS_NOMOVEY=2
_CCS_NOPARENTALIGN=8
_CCS_NORESIZE=4
_CCS_RIGHT=0x83
_CCS_TOP=1
_CCS_VERT=0x80
_TBIF_COMMAND=0x20
_TBIF_IMAGE=1
_TBIF_LPARAM=0x10
_TBIF_SIZE=0x40
_TBIF_STATE=4
_TBIF_STYLE=8
_TBIF_TEXT=2
_TBSTYLE_ALTDRAG=0x400
_TBSTYLE_AUTOSIZE=0x10
_TBSTYLE_BUTTON=0
_TBSTYLE_CHECK=2
_TBSTYLE_CHECKGROUP=6
_TBSTYLE_CUSTOMERASE=0x2000
_TBSTYLE_DROPDOWN=8
_TBSTYLE_FLAT=0x800
_TBSTYLE_GROUP=4
_TBSTYLE_LIST=0x1000
_TBSTYLE_NOPREFIX=0x20
_TBSTYLE_REGISTERDROP=0x4000
_TBSTYLE_SEP=1
_TBSTYLE_TOOLTIPS=0x100
_TBSTYLE_TRANSPARENT=0x8000
_TBSTYLE_WRAPABLE=0x200
_TB_CHANGEBITMAP=0x42B
_TB_GETBITMAP=0x42C
_TB_GETBUTTONSIZE=0x43A
_TB_GETBUTTONTEXT=0x42D
_TB_GETDISABLEDIMAGELIST=0x437
_TB_GETRECT=0x433
_TB_GETSTYLE=0x439
_TB_GETTOOLTIPS=0x423
_TB_SETBUTTONWIDTH=0x43B
_TB_SETDISABLEDIMAGELIST=0x436
_TB_SETSTYLE=0x438
_TB_SETTOOLTIPS=0x424

Markdown 格式