# win.ui.ctrl.static 库模块帮助文档 ## win.ui.ctrl 成员列表 # ### win.ui.ctrl.static # 静态文本控件支持库 ### win.ui.ctrl.static() # 静态文本控件 [返回对象:staticObject](#staticObject) ## staticObject 成员列表 # ### staticObject._defWindowProc(hwnd,message,wParam,lParam) # 用于在 wndproc 回调中提前调用默认消息回调函数, 所有窗口和控件定义了 wndproc 回调以后会自动创建这个函数, 调用此函数以后,wndproc 必须指定非 null 返回值, 以避免再次重复调用默认回调函数 ### staticObject._embedObject # 嵌入 COM 控件的容器对象 [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### staticObject._parentForm # 返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，控件的 _parentForm 始终都不会改变 [返回对象:winform](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/_.html#winform) ### staticObject.addCtrl() # [返回对象:staticObject](#staticObject) ### staticObject.addCtrl(controlsPropertiesTable) # ```aardio staticObject.addCtrl( cls="plus"; text="4"; font=LOGFONT(name='Marlett';h=-16); marginRight=0;marginBottom=2; width=32;/*在 plus 控件内部添加子控件。参数 @1 可指定以下三种类型参数： - 指定包含名值对的表，名为添加到父窗体的控件名称，值为控件构造参数表。返回值为名值对（值为控件对象）。 - 包含一个或多个创建匿名控件参数表的数组。返回值为数组（数组元素为创建的控件对象）。 - 直接指定创建单个控件的构造参数表，必须指定 cls 字段。返回创建的控件对象。 */ ) ``` ### staticObject.adjust # ```aardio staticObject.adjust = function( cx,cy,wParam ) { /*父窗口改变大小后会自动触发此事件函数。注意 onSize 是 adjust 事件的别名，作用相同。所有 win.form 创建的窗体和控件都支持 adjust 事件, 重复赋值 adjust 会追加事件触发器而非替换原来的值。 cx 参数为窗口客户区宽度,cy 参数为窗口客户区高度, wParam 参数来自 _WM_SIZE 消息的 wParam 参数，一般不用管。一般不建议添加一个 wndproc 仅仅是为了处理 _WM_SIZE 消息，定义 adjust 事件是更好的选择。如果主动调用此函数，则检查并执行所有之前添加的 adjust 事件函数。省略调用参数时 cx,cy 参数默认设为窗口大小*/ }; ``` ### staticObject.afterDpiChanged # ```aardio staticObject.afterDpiChanged = function(scaleX,scaleY,origScaleX,origScaleY){ /*DPI 缩放后回调此函数。 scaleX,scaleY 为 DPI 缩放倍数（例如 2 表示 200% 缩放）。 origScaleX,origScaleY 为缩放前的倍数。*/ } ``` ### staticObject.appendText() # 追加文本。可指定一个或多个字符串参数（数值可自动转字符串） ### staticObject.autoResize # 是否允许跟随父窗体自动缩放 ### staticObject.bgcolor # 获取或修改景颜色数值 ### staticObject.bottom # 底部坐标 ### staticObject.capture # 是否捕获全局鼠标消息 ### staticObject.center(目标窗口) # 在目标窗口区域内居中，并调整以保证显示在父窗口或屏幕工作区内。参数 @1 可指定目标窗口或者目标窗口句柄，设为 0 表示桌面，省略目标窗口则默认取父窗口或所有者窗口。 ### staticObject.changeInterval(定时器ID,间隔时间,回调函数) # 重新设置间隔时间或回调函数 ### staticObject.className # 运行时类名 ### staticObject.clearInterval(定时器ID) # 删除定时器。参数如果为 null 则忽略不执行，否则定时器ID必须是 setInterval 函数或setTimeout函数的返回值。请注意如果定时器被删除，ID 可能被重新分配给其他定时器。在定时器回调函数中返回 0,false 以删除定时器是更稳妥的方式 ### staticObject.clearTimeout(定时器ID) # 删除定时器。参数如果为 null 则忽略不执行，否则定时器ID必须是 setInterval 函数或setTimeout函数的返回值。请注意如果定时器被删除，ID 可能被重新分配给其他定时器。在定时器回调函数中返回 0,false 以删除定时器是更稳妥的方式 ### staticObject.clientHeight # 控件窗口客户区宽度，只读属性。 ### staticObject.clientWidth # 控件窗口客户区宽度，只读属性。 ### staticObject.close() # 关闭控件窗口 ### staticObject.cls # 设计时类名 ### staticObject.color # 获取或修改字体颜色数值 ### staticObject.createEmbed # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象。通常使用 util.metaProperty 为容器对象添加属性元表，属性元表可拦截属性、函数调用并调用 _object 对象, createEmbedEx 返回的容器已添加默认代理以直接访问 COM 对象 ### staticObject.createEmbed() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### staticObject.createEmbed(clsId,embedObj) # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @clsId 指定控件 CLSID, 可选在参数@2中指定 COM 对象绑定的容器对象此函数失败会抛出异常 ### staticObject.createEmbed(comObject,embedObj) # 嵌入 COM 控件,返回控件容器对象, 容器对象的 _object 成员是传入的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @comObject 指定已创建成功的 COM 对象, 可选在参数@2中指定 COM 对象绑定的容器对象此函数失败会抛出异常 ### staticObject.createEmbedEx # 创建嵌入 COM 控件，返回控件容器对象。容器对象的 _object 成员是创建的 COM 对象。容器对象的 __event__ 成员为 COM 对象默认事件监听器。在窗口销毁时解除默认事件监听器并释放 COM 对象。返回容器已添加元表，可通过容器对象的成员代理访问 COM 对象成员。也可以通过指定容器对象的成员函数响应 COM 对象事件 ### staticObject.createEmbedEx() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### staticObject.createEmbedEx(clsId,embedObj) # 创建嵌入 COM 控件，返回控件容器对象。此函数返回的容器已添加元表并创建代理以直接访问 COM 对象，也可以通过指定容器对象的成员函数响应 COM 对象事件。 @clsId 指定控件 CLSID，可选在参数 @2 中指定 COM 对象绑定的容器对象。此函数失败会抛出异常 ### staticObject.createEmbedEx(comObject,embedObj) # 嵌入 COM 控件，返回控件容器对象。此函数返回的容器已添加元表并创建代理以直接访问 COM对象，也可以通过指定容器对象的成员函数响应 COM 对象事件。参数 @comObject 指定已创建成功的 COM 对象, 可选在参数 @2 中指定 COM 对象绑定的容器对象。此函数失败会抛出异常 ### staticObject.disabled # 是否禁用 ### staticObject.disabledText # 指定文本时,禁用此控件,并显示指定文本, 指定为null时,启用此控件,并恢复控件之前的正常文本 ### staticObject.dpiScale(x,y) # 将 @x,@y 表示的像素值乘以窗体当前 DPI 缩放倍数并返回, 省略 @y 参数时仅返回 @x 转换后的值, 所有 win.ui 创建的窗口或控件都提供这个函数 ### staticObject.dpiScaleX # 窗口当前使用的DPI横坐标缩放系数, 该值由界面系统自动维护，任何情况下都不应手动修改, 这是一个以小数表示百分比的数，例如 1.25 表示 125%, 窗口未使用缩放或未完成缩放初始化时，值可能为 null，如果要获取屏幕缩放设置应改用 gdi.getDpiScale 函数 ### staticObject.dpiScaleY # 窗口当前使用的DPI纵坐标缩放系数, 该值由界面系统自动维护，任何情况下都不应手动修改, 这是一个以小数表示百分比的数，例如 1.25 表示 125%, 窗口未使用缩放或未完成缩放初始化时，值可能为 null，如果要获取屏幕缩放设置应改用 gdi.getDpiScale 函数 ### staticObject.ellipsis # 超出显示范围如何显示省略号，可选值： "path" 单行显示，在最后一个反斜杠前显示省略号 "end" 单行显示，字符串末尾超出显示范围则显示省略号 null 不显示省略号 ### staticObject.enableDpiScaling(false) # 禁用DPI自动缩放, 不指定参数启用DPI自动缩放,默认已启用 ### staticObject.font # 控件字体（LOGFONT 结构体），注意获取该属性总是返回新的 LOGFONT 对象，修改返回字体并不会更新控件字体，除非重新赋值。建议尽量优先使用 getFont 或 setFont 函数，以增强代码可读性字体会根据控件设置自动处理 DPI 缩放，不需要事先缩放字体大小 ### staticObject.getClientRect() # 控件客户区块位置(::RECT结构体) [返回对象:rectObject](https://www.aardio.com/zh-cn/doc/library-reference/global/_.html#rectObject) ### staticObject.getFont() # 返回控件 LOGFONT 字体，返回对象的 h 值会按控件的 DPI 缩放设置自动还原为缩放前大小。 [返回对象:logfontObject](#logfontObject) ### staticObject.getFont(true) # 返回控件 LOGFONT 字体，返回对象的 h 值为字体实际大小，不会按控件 DPI 设置还原。返回字体会设置 noScale 属性为 true, 使用控件的 setFont 函数或赋值 font 属性时， noScale 属性为 true 的字体同样不会进行自动 DPI 缩放 [返回对象:logfontObject](#logfontObject) ### staticObject.getForm() # 标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。 win.form 创建的窗体对象返回自身，其他控件对象返回创建控件的容器窗口（ _parentForm 属性） ### staticObject.getParent() # 返回父窗口 [返回对象:staticObject](#staticObject) ### staticObject.getPos() # 返回相对父窗口客户区的坐标,宽,高, 参数为true返回屏幕坐标,宽,高, x,y,cx,cy=win.getPos(hwnd) ### staticObject.getRect() # 控件区块位置(::RECT结构体) ### staticObject.getRect(true) # 控件屏幕区块位置(::RECT结构体) ### staticObject.getRoot() # 获取顶层父窗口，这个函数会查找 orphanWindow 的父窗口 ### staticObject.getScale() # 返回 X 轴、Y 轴方向缩放比例，DPI 缩放比例共 4 个返回值, scaleX,scaleY,dpiScaleX,dpiScale 。 win.ui 创建的所有窗体与控件对象都提供此方法。 ### staticObject.group() # 将在此控件范围内的所有其他控件设为此控件的子窗口 ### staticObject.height # 高度 ### staticObject.hide # 当前控件窗口是否隐藏。仅检查当前窗口的可见性样式（窗口是否移除了 _WS_VISIBLE 样式）。不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。以 `.` 前导的 `.hide()` 作为成员函数被调用时，作用等价于将 hide 属性设为 null 。 ### staticObject.hwnd # 控件句柄 ### staticObject.id # 控件ID ### staticObject.invalidate(/*可选使用::RECT()对象指定客户区*/) # 使窗口绘图区无效 ### staticObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) # 使窗口绘图区无效不刷新背景 ### staticObject.isDialogMessage # ```aardio staticObject.isDialogMessage = function(hParent,msg){/*在控件范围内替代父窗口的 isDialogMessage，可用于在控件范围内屏蔽对话框快捷键。可用于禁用 tab 控制键的多行文本框支持按 tab 输入制表符*/} ``` ### staticObject.isForm # 标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。 win.form 创建的窗体对象返回 true,其他控件对象返回 false 。 ### staticObject.left # 左侧坐标 ### staticObject.messageOnly() # 将窗口转换为message-only window 该窗口不可见,仅用于消息分发 ### staticObject.modifyStyle(remove,add,swpFlags) # 修改窗口样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### staticObject.modifyStyleEx(remove,add,swpFlags) # 修改窗口扩展样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### staticObject.msgAsk(text) # 显示询问提示框。参数 @text 指定要显示的文本信息。用户按确定或回车返回 true ，其他返回 false 或 null 。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgErr(text,timeout) # 显示错误提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgFrown(text,timeout) # 显示皱眉图标提示框。参数 @text 指定要显示的文本信息。可选用参数 @2 指定延时关闭的毫秒数, 请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgGreat(text,timeout) # 显示竖大拇指图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgInfo(text,timeout) # 显示提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgOk(text,timeout) # 显示正确提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgSmile(text,timeout) # 显示微笑图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgSorry(text,timeout) # 显示倒竖大拇指图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgWarn(text,timeout) # 显示警告提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### staticObject.msgbox(text,title,style,timeout) # 弹出对话框 1. 参数 @text 指定显示的数据，如果指表对象则先序列化为文本。参数 @text 是其他类型则调用 tostring 转换为文本。 2. 可选参数 @title 用于指定信息框标题。 3. 可选参数 @style 可用字符串或数值指定图标样式（参考 _MB_ 前缀常量值，设为 0 去掉图标与提示音），也可以指定字符串值： * "error","stop","hand" 错误图标 * "question" 询问图标，显示是、否、取消按钮，返回值为 `6/*_IDYES*/,7/*_IDNO*/, 2/*_IDCANCEL*/` 之一。 * "confirm","test" 询问图标，显示确定与取消按钮，返回值为 `1/*_IDOK*/,2/*_IDCANCEL*/` 之一。 - "warn" 警告图标 * "info" 信息图标。 4. 可选用参数 @timeout 限定显示时间，以毫秒为单位，超时自动关闭。 ### staticObject.msgboxErr(text,title) # 弹出错误对话框参数 @text 指定显示的信息，如果指定表对象先序列化为文本。其他对象调用 tostring 转换为文本可选参数 @title 用于指定信息框标题。此函数调用 win.msgbox，并设定所有者窗口为当前窗体。 ### staticObject.msgboxTest(text,title) # 弹出询问对话框参数 @text 指定显示的信息，如果指定表对象先序列化为文本。其他对象调用 tostring 转换为文本可选参数 @title 用于指定信息框标题。此函数调用 win.msgbox，并设定所有者窗口为当前窗体。 ### staticObject.oncommand # ```aardio staticObject.oncommand = function(id,event){ /*命令事件触发*/ } ``` ### staticObject.onnotify # ```aardio staticObject.onnotify = function(id,code,ptr){ /*通知事件触发*/ } ``` ### staticObject.orphanWindow # 如果当前是子窗口, 移除窗口的WS_CHILD样式，使窗口孤立出来悬浮于原位置, 悬浮窗口如影随形的跟随父窗口移动或改变大小,控件原来的固定边距等参数仍然有效 ### staticObject.orphanWindow(transparent,hwndBuddy,borderless) # 创建悬浮窗口。悬浮窗口是模仿子窗口外观效果的独立窗口，父窗口可自动调整子窗口到设定位置。可选参数 @transparent 为 true 则转换为分层透明窗口。可选利用 @hwndBuddy 参数指定外部进程窗口句柄的并附加在内部控件上以实现相同的效果。伙伴窗口总是会保持在悬浮窗口前面，并保持相同的大小、位置。可重复调用此函数更换伙伴窗口，旧的伙伴窗口必须自行关闭。可选指定 @borderless 参数为 true 以移除 @hwndBuddy 的窗口边框。 ### staticObject.postMessage(msg,wParam,lParam) # 投递窗口消息到消息队列中此函数用法请参考 ::User32.PostMessage ### staticObject.preadjust # ```aardio staticObject.preadjust = function( cx,cy,wParam ) { /*窗口缩放后重绘前、触发 adjust 事件之前触发此事件。所有 win.form 创建的窗体和控件都支持此事件, 与 adjust 事件不同，对 preadjust 重复赋值则覆盖而不是追加事件。 cx 参数为窗口宽度,cy 参数为窗口高度, wParam 为 _WM_SIZE 消息参数。*/ }; ``` ### staticObject.publish("字符串参数",) # 在窗口所在界面线程发布消息, 运行界面线程所有所有调用 subscribe 函数订阅此消息的函数, 可添加任意个触发参数 ### staticObject.redraw() # 刷新 ### staticObject.redrawTransparent() # 刷新透明背景时请使用此函数替代redraw() ### staticObject.reduce(array,callback,debounce) # ```aardio staticObject.reduce( [/*参数 1 @array 指定要循环处理每个元素的数组或表。 @array 指定为 false 则取消之前创建的防抖单例循环。参数 2 @callback 指定回调函数。回调函数中可返回本次间隔延时，以毫秒为单位。返回 0、null、false、以及不能转换为非 0 数的值中断处理。回调参数为：当前数组元素值,当前索引,数组长度,本轮动画已执行毫秒数, 处理到数组尾部时回调参数 @1 为 null, 如果此时仍然返回可转换为非 0 数的值,将转到第一个数组元素重复循环。参数 3 @debounce 指定是否创建为防抖单例循环，默认为 true。*/], function(value,index,length,currentTime){ if(value){ var duration = 2000; var x = currentTime/duration; var change = 1+length*(x * x * x * x); var delay = (duration / length) / change; return delay; } } ) ``` ### staticObject.reloadScale() # 按设计时位置参数、重新调整控件位置以适应窗口当前缩放比例。父窗口缩放时会自动执行此操作。默认在启动窗口消息循环时会自适应调整所有控件。所以在启动消息循环前添加控件不必调用此函数 ### staticObject.resize(宽度,高度) # 如果指定了参数则调整窗口大小, 无论是否实际调整窗口大小,发送 _WM_SIZE 消息给窗口 ### staticObject.right # 右侧坐标 ### staticObject.saveScale() # 根据控件当前位置、缩放比例，更新控件的设计时位置参数。以避免下次窗口缩放自适应调整控件当前位置更改被清除，控件所有调整位置的属性或成员函数已自动调用此函数。 ### staticObject.sendMessage(msg,wParam,lParam) # 发送窗口消息此函数用法请参考 ::User32.SendMessage ### staticObject.setFocus() # 设置焦点 ### staticObject.setFont(指定字体) # 指定 LOGFONT 字体对象,或逻辑字体句柄如果不指定 point 值并指定 h 值，字体会按控件的 DPI 缩放设置自动缩放。 ### staticObject.setFont(混入字体属性) # ```aardio staticObject.setFont(h=-12;name="Tahoma"); ``` ### staticObject.setInterval(回调函数,延时毫秒数,...) # ```aardio staticObject.setInterval(回调函数,延时毫秒数,...setInterval( function(){ /*参数@1指定执行函数,参数@2指定执行间隔，可选指定一个或多个回调参数，不指定回调参数则默认为: hwnd,message,timerId,tick, 如果在定时器中执行了win.delay等继续消息循环的代码，在定时器退出前不会再触发同一定时器（重入）。定时器回调函数返回数值可修改时间间隔, 返回false取消该定时器*/ },1000 ) ``` ### staticObject.setParent(控件对象) # 改变父窗口 ### staticObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) # 调整窗口位置或排序,所有参数可选同时指定x,y坐标则移动位置同时指定宽高则改变大小指定插入位置(句柄或_HWND前缀常量)则调整Z序 ### staticObject.setRect(rc) # 设置控件区块位置(::RECT结构体) ### staticObject.setRect(rc,true) # 设置控件屏幕区块位置(::RECT结构体) ### staticObject.setRedraw(false) # 禁止重绘 ### staticObject.setRedraw(true) # 恢复重绘 ### staticObject.setTimeout(函数或代码,延时,其他附加参数) # 推迟执行指定的函数或代码此函数异步执行参数中指定的函数，不会阻塞当前代码继续执行，延时参数是可选参数，以毫秒为单位，默认为0毫秒可选用附加参数指定调用延时函数的实参返回值为定时器ID ### staticObject.show(true) # 显示控件 ### staticObject.tabNext() # [返回对象:staticObject](#staticObject) ### staticObject.tabNext(移动焦点,是否反向) # 获取下一个支持tab控制焦点的控件参数@1为true会自动移动焦点到该控件参数@2为true则获取上一个控件,否则获取下一个控件 ### staticObject.text # 控件文本 ### staticObject.theme # 外观主题,例如 winform.button.theme = "Explorer" winform.button.theme = false ### staticObject.threadCallable() # 开启此控件的跨线程调用功能 ### staticObject.toClient(x,y) # 将参数 x,y 指定的屏幕坐标转换为当前控件客户区坐标。返回 2 个值：x,y ### staticObject.toScreen(x,y) # 将参数 x,y 指定的当前控件客户区坐标转换为屏幕坐标。返回 2 个值：x,y ### staticObject.top # 顶部坐标 ### staticObject.translateAccelerator # ```aardio staticObject.translateAccelerator = function(msg){ if( msg.wParam == 0x20/*_VK_SPACE*/ & msg.message = 0x101/*_WM_KEYUP*/){ return true;/*返回是否快捷键,适用窗体或普通控件对象仅当前窗口内的按键触发此事件 msg 参数为包含窗口按键消息的 ::MSG 结构体*/ } } ``` ### staticObject.translateCommand() # 允许转发转发子窗口的命令（_WM_COMMAND）与通知（_WM_NOTIFY）消息，避免子窗口 oncommand，onnotify 等回调失效。同时会处理子窗口的 _WM_CTLCOLORSTATIC 等消息，以避免部分外观属性失效 ### staticObject.tryCreateEmbed # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象。通常使用 util.metaProperty 为容器对象添加属性元表，属性元表可拦截属性、函数调用并调用 _object 对象, createEmbedEx 返回的容器已添加默认代理以直接访问 COM 对象 ### staticObject.tryCreateEmbed() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### staticObject.tryCreateEmbed(clsId,embedObj) # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @clsId 指定控件 CLSID, 可选在参数@2中指定 COM 对象绑定的容器对象成功返回容器对象,失败返回false,错误信息 ### staticObject.update() # 重绘invalidate函数指定的区块 ### staticObject.valid # 窗口是否有效，窗口未关闭返回 true ，窗口已关闭或正在关闭返回 false ### staticObject.value # 控件文本，text 属性的别名。 ### staticObject.wait(等待函数,超时,延时间隔) # 循环执行等待函数,并等待返回值直到等待函数返回非空值,或存在第二个返回值,或当前窗口关闭等待函数返回的值就是wait函数的返回值, 如果指定超时,超过指定毫秒时返回null, 除等待函数以外,所有参数可选 ### staticObject.width # 宽度 ### staticObject.wndproc # ```aardio staticObject.wndproc = function(hwnd,message,wParam,lParam){ /*窗口消息回调，返回任意非null值阻止默认回调 wndproc重复赋值时追加函数而不是覆盖之前的回调设为null添除所有消息回调函数 wndproc也可以是一个表,键要为处理的消息,值为对应的消息回调函数*/ } ``` ## staticObject 事件列表 # ### staticObject.onDestroy # ```aardio staticObject.onDestroy = function(){ /*窗口销毁前触发*/ } ``` ### staticObject.onSize # ```aardio staticObject.onSize = function( width,height,wParam ) { /*父窗口改变大小后会自动触发此事件函数。注意 onSize 是 adjust 事件的别名，作用相同所有 win.form 创建的窗体和控件都支持 onSize（或 adjust）事件, 重复赋值 onSize（或 adjust）会追加事件触发器而非替换原来的值。 width 参数为窗口客户区宽度,height 参数为窗口客户区高度, wParam 参数来自 _WM_SIZE 消息的 wParam 参数，一般不用管。一般不建议添加一个 wndproc 仅仅是为了处理 _WM_SIZE 消息，定义 onSize 事件是更好的选择。 };*/ ```