# win.ui.toolbar 库模块帮助文档 ## toolbarButtonObject 成员列表 # ### toolbarButtonObject.checked # 是否选中 ### toolbarButtonObject.click() # 点击按钮 ### toolbarButtonObject.delete() # 删除按钮 ### toolbarButtonObject.disabled # 是否禁用 ### toolbarButtonObject.getInfo( _TBIF ) # 获取TBBUTTONINFO结构体 ### toolbarButtonObject.getRect() # 返回按钮区块 [返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject) ### toolbarButtonObject.id # 命令ID ### toolbarButtonObject.index() # 返回按钮索引 ### toolbarButtonObject.setInfo( ) # 设置TBBUTTONINFO结构体,可指定部分字段 ### toolbarButtonObject.state # 读写按钮状态 ### toolbarButtonObject.text # 按钮文本 ## toolbarObject 成员列表 # ### toolbarObject.add() # 添加一个分隔条 [返回对象:toolbarButtonObject](#toolbarButtonObject) ### toolbarObject.add(标题,回调函数,图像索引,可选指定命令ID) # ```aardio 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](#toolbarButtonObject) ### toolbarObject.getButton(索引) # 返回按钮对象 ### toolbarObject.getButtonById() # [返回对象:toolbarButtonObject](#toolbarButtonObject) ### toolbarObject.getButtonById(idCommand) # 返回按钮对象 ### toolbarObject.getClientRect() # 控件客户区块位置，返回值为 ::RECT结构体 [返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject) ### toolbarObject.getExtended() # 获取工具条扩展样式 ### toolbarObject.getExtended(exstyle) # 获取工具条指定扩展样式 ### toolbarObject.getFont(true) # 返回控件字体，返回值为 ::LOGFONT 结构体 [返回对象:logfontObject](#logfontObject) ### toolbarObject.getForm() # 标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。 win.form 创建的窗体对象返回自身，其他控件对象返回创建控件的容器窗口（ _parentForm 属性）。 ### toolbarObject.getNotifyInfo(ptr) # 在通知回调中获取 PNMTOOLBAR 结构体， ptr 为 onnotify 回调传过来的指针参数 ### toolbarObject.getParent() # 返回父窗口 [返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform) ### toolbarObject.getPos() # 返回相对父窗口客户区的坐标,宽,高, 参数为 true 返回屏幕坐标,宽,高注意工具条是默认已经做过 DPI 缩放的，所以请在 winform.enableDpiScaling("init"); 以后使用这些属性 ### toolbarObject.getRect() # 控件区块位置，返回值为 ::RECT结构体 [返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject) ### toolbarObject.getRect(true) # 控件屏幕区块位置，返回值为 ::RECT结构体 ### toolbarObject.getRoot() # 获取顶层父窗口 ### toolbarObject.height # 获取时返回工具条实际高度。只能获取，修改无效。注意工具条是默认已经做过 DPI 缩放的，所以请在 winform.enableDpiScaling("init"); 以后使用这些属性 ### toolbarObject.hwnd # 控件句柄 ### toolbarObject.imageList # 指定工具条控件的图像列表。指定的图像列表支持 DPI 自适应缩放发送 _CCM_DPISCALE 消息且其他参数为 0 可关闭 DPI 自适应 ### toolbarObject.left # 左侧坐标。只能获取，修改无效注意工具条是默认已经做过 DPI 缩放的，所以请在 winform.enableDpiScaling("init"); 以后使用这些属性 ### toolbarObject.modifyStyle(移除样式,添加样式) # 所有参数可选,默认为0 使用 _TBSTYLE_ 前缀常量表示样式 ### toolbarObject.onnotify # ```aardio 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.visible # 当前控件窗口是否显示。仅检查当前窗口的可见性样式（窗口是否具有 _WS_VISIBLE 样式）。不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。 ### toolbarObject.width # 工具条宽度。只能获取，修改无效注意工具条是默认已经做过 DPI 缩放的，所以请在 winform.enableDpiScaling("init"); 以后使用这些属性 ### toolbarObject.wndproc # ```aardio toolbarObject.wndproc = function(hwnd,message,wParam,lParam){ /*窗口消息回调，返回任意非null值阻止默认回调 wndproc重复赋值时追加函数而不是覆盖之前的回调设为null添除所有消息回调函数 wndproc也可以是一个表,键要为处理的消息,值为对应的消息回调函数*/ } ``` ## toolbarObject 事件列表 # ### toolbarObject.onDestroy # ```aardio toolbarObject.onDestroy = function(){ /*窗口销毁前触发*/ } ``` ## toolbarObject.buttons 成员列表 # ### toolbarObject.buttons.* # [返回对象:toolbarButtonObject](#toolbarButtonObject) ## win.ui 成员列表 # ### win.ui.toolbar() [返回对象:toolbarObject](#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