# win.ui.ctrl.plus 库模块帮助文档 ## win.ui.ctrl 成员列表 # ### win.ui.ctrl.plus() # 高级图像控件 [返回对象:uiCtrlPlusObject](#uiCtrlPlusObject) ## uiCtrlPlusObject 成员列表 # ### uiCtrlPlusObject._embedObject # 嵌入 COM 控件的容器对象 [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### uiCtrlPlusObject._parentForm # 返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，控件的 _parentForm 始终都不会改变 [返回对象:winform](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/_.html#winform) ### uiCtrlPlusObject.addCtrl() # [返回对象:uiCtrlPlusObject](#uiCtrlPlusObject) ### uiCtrlPlusObject.addCtrl(controlsPropertiesTable) # ```aardio uiCtrlPlusObject.addCtrl( cls="plus"; marginRight=0;marginBottom=2; width=32; iconText = '\uF023'; iconStyle={ align="right";font=LOGFONT(h=-15;name='FontAwesome');padding={top=3} } /*在 plus 控件内部添加子控件。参数 @1 可指定以下三种类型参数： - 指定包含名值对的表，名为添加到父窗体的控件名称，值为控件构造参数表。返回值为名值对（值为控件对象）。 - 包含一个或多个创建匿名控件参数表的数组。返回值为数组（数组元素为创建的控件对象）。 - 直接指定创建单个控件的构造参数表，必须指定 cls 字段。返回创建的控件对象。 */ ) ``` ### uiCtrlPlusObject.adjust # ```aardio uiCtrlPlusObject.adjust = function( cx,cy,wParam ) { /*父窗口改变大小后会自动触发此事件函数。注意 onSize 是 adjust 事件的别名，作用相同。所有 win.form 创建的窗体和控件都支持 adjust 事件, 重复赋值 adjust 会追加事件触发器而非替换原来的值。 cx 参数为窗口客户区宽度,cy 参数为窗口客户区高度, wParam 参数来自 _WM_SIZE 消息的 wParam 参数，一般不用管。一般不建议添加一个 wndproc 仅仅是为了处理 _WM_SIZE 消息，定义 adjust 事件是更好的选择。如果主动调用此函数，则检查并执行所有之前添加的 adjust 事件函数。省略调用参数时 cx,cy 参数默认设为窗口大小*/ }; ``` ### uiCtrlPlusObject.afterDpiChanged # ```aardio uiCtrlPlusObject.afterDpiChanged = function(scaleX,scaleY,origScaleX,origScaleY){ /*DPI 缩放后回调此函数。 scaleX,scaleY 为 DPI 缩放倍数（例如 2 表示 200% 缩放）。 origScaleX,origScaleY 为缩放前的倍数。*/ } ``` ### uiCtrlPlusObject.align # 文本水平对齐, 左对齐："left" 居中："center" 右对齐："right" 图标文本请使用 iconStyle 属性的 align 字段指定水平对齐 ### uiCtrlPlusObject.animation # 是否允许自动播放 GIF 动画，指定为 false 禁止自动播放。 ### uiCtrlPlusObject.animationId # 动画定时器ID 不可改动，可用于判断动画是否启动 ### uiCtrlPlusObject.animationState # 此属性表示动画当前状态值,值null或false表示动画已停止 ### uiCtrlPlusObject.appendText() # 追加文本。可指定一个或多个字符串参数（数值可自动转字符串）。如果 plus 控件启用了编辑模式则调用编辑框的 appendText 方法。 ### uiCtrlPlusObject.argbColor # 8888 ARGB 格式（ 0xAARRGGBB ）字体颜色,支持透明或半透明。注意plus控件、GDI+都是ARGB格式数值表示颜色分量,即:0xAARRGGBB 与RGB的分量顺序是反过来的 ### uiCtrlPlusObject.autoResize # 是否允许跟随父窗体自动缩放 ### uiCtrlPlusObject.background # 背景图像或背景色, 获取值是返回 gdip.bitmap 对象或 ARGB 格式颜色数值，赋值时可指定图像路径、资源路径、gdip.bitmap 对象、颜色值，颜色值使用0xAARRGGBB格式的数值。赋值时指定一个路径或资源路径控件将自动缓存使用频繁的图像内存图像建议使用setBackground函数指定缓存名 [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.backgroundColor # 当前状态背景颜色, 修改背景色建议设置 background 属性为数值即可，直接修改 backgroundColor 不会释放之前的背景图像且不会重绘 ### uiCtrlPlusObject.bkBottom # 背景图expand模式下九宫格切图的底部切线 ### uiCtrlPlusObject.bkLeft # 背景图expand模式下九宫格切图的左侧切线 ### uiCtrlPlusObject.bkRight # 背景图expand模式下九宫格切图的右侧切线如果控件显示为水平滑块控件,此属性用于预留滑块按钮大小 ### uiCtrlPlusObject.bkTop # 背景图expand模式下九宫格切图的顶部切线 ### uiCtrlPlusObject.border # ```aardio uiCtrlPlusObject.border = {color=0x805F9EA0;radius=11;width=2}/*使用一个表对象指定当前边框样式，支持的字段请参考窗体设计器中设置边框样式生成的代码，表的其他可用字段与 skin 函数指定的 border 样式相同，请参考范例。修改此属性不会触发重绘。可使用 predraw 或 redraw,redrawTransparent 等函数重绘*/ ``` ### uiCtrlPlusObject.bottom # 底部坐标 ### uiCtrlPlusObject.capture # 是否捕获全局鼠标消息 ### uiCtrlPlusObject.center(目标窗口) # 在目标窗口区域内居中，并调整以保证显示在父窗口或屏幕工作区内。参数 @1 可指定目标窗口或者目标窗口句柄，设为 0 表示桌面，省略目标窗口则默认取父窗口或所有者窗口。 ### uiCtrlPlusObject.changeInterval(定时器ID,间隔时间,回调函数) # 重新设置间隔时间或回调函数 ### uiCtrlPlusObject.checked # 该属性可用于切换选取状态 ### uiCtrlPlusObject.className # 运行时类名 ### uiCtrlPlusObject.clearInterval(定时器ID) # 删除定时器。参数如果为 null 则忽略不执行，否则定时器ID必须是 setInterval 函数或setTimeout函数的返回值。请注意如果定时器被删除，ID 可能被重新分配给其他定时器。在定时器回调函数中返回 0,false 以删除定时器是更稳妥的方式 ### uiCtrlPlusObject.clearTimeout(定时器ID) # 删除定时器。参数如果为 null 则忽略不执行，否则定时器ID必须是 setInterval 函数或setTimeout函数的返回值。请注意如果定时器被删除，ID 可能被重新分配给其他定时器。在定时器回调函数中返回 0,false 以删除定时器是更稳妥的方式 ### uiCtrlPlusObject.clientHeight # 控件窗口客户区宽度，只读属性 ### uiCtrlPlusObject.clientWidth # 控件窗口客户区宽度，只读属性。 ### uiCtrlPlusObject.close() # 关闭控件窗口 ### uiCtrlPlusObject.cls # 设计时类名 ### uiCtrlPlusObject.color # 支持 0xBBGGRR 格式或 0xAARRGGBB 格式字体颜色， 0xAARRGGBB 格式中的 AA 必须是非 0 值，否则视为 0xBBGGRR 格式。如果启用了编辑模式,可同步修改编辑框字体颜色, 注意使用argbColor修改颜色不能同步修改编辑框颜色 ### uiCtrlPlusObject.createEditBox(创建控件参数) # ```aardio uiCtrlPlusObject.createEditBox( vscroll = true; hscroll = true; multiline = true; );/*创建并启用透明背景的richedit文本编辑框，可用参数与窗体设计器相同，创建文本框时应用plus控件预设的字体、颜色、水平对齐方式，并且使用plus控件预设的内边距限制文本编辑框显示范围。可使用editBox属性访问此文本编辑框，可通过设置plus控件的editable属性显示或隐藏文本编辑框*/ ``` ### uiCtrlPlusObject.createEmbed # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象。通常使用 util.metaProperty 为容器对象添加属性元表，属性元表可拦截属性、函数调用并调用 _object 对象, createEmbedEx 返回的容器已添加默认代理以直接访问 COM 对象 ### uiCtrlPlusObject.createEmbed() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### uiCtrlPlusObject.createEmbed(clsId,embedObj) # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @clsId 指定控件 CLSID, 可选在参数@2中指定 COM 对象绑定的容器对象此函数失败会抛出异常 ### uiCtrlPlusObject.createEmbed(comObject,embedObj) # 嵌入 COM 控件,返回控件容器对象, 容器对象的 _object 成员是传入的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @comObject 指定已创建成功的 COM 对象, 可选在参数@2中指定 COM 对象绑定的容器对象此函数失败会抛出异常 ### uiCtrlPlusObject.createEmbedEx # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象。此函数返回的容器已添加元表并创建代理以直接访问 COM 对象 ### uiCtrlPlusObject.createEmbedEx() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### uiCtrlPlusObject.createEmbedEx(clsId,embedObj) # 创建嵌入控件,返回控件容器对象, 此函数返回的容器已添加元表并创建代理以直接访问 COM 对象, @clsId 指定控件 CLSID,如果控件不是自内存加载, 则可省略 @clsId 并由 firstCoClassId函数自动获, 可选在参数@2中指定 COM 对象绑定的容器对象此函数失败会抛出异常 ### uiCtrlPlusObject.cursor # 用于自定义光标（鼠标指针），启用事件通知后生效。可用数值（例如 `32649/*_IDC_HAND*/`）或以下字符串值指定指定预定义光标 ID: `arrow,ibeam,wait,cross,upArrow, sizeNWSE,sizeNESW,sizeWE,sizeNS,sizeAll, no,hand,appstarting,help,pin,person` 也可指定为 ::User32.LoadCursor 等函数加载的光标句柄（`pointer`类型）。设为 null 值恢复默认光标。调用 skin 函数时指定 cursor 字段也可修改此属性 ### uiCtrlPlusObject.directDrawBackgroundOnly() # 允许直接在背景窗口上画图并禁止控件在自己的窗口绘图 ### uiCtrlPlusObject.disablePaint() # 禁用默认绘图操作 ### uiCtrlPlusObject.disabled # 是否禁用 ### uiCtrlPlusObject.disabledText # ```aardio uiCtrlPlusObject.disabledText = ['\uF254','\uF251','\uF252','\uF253','\uF250',text='']/*disabledText 属性可以指定 3 种类型的值： 1. 如果 disabledText 指定字符串值，则禁用此控件并显示指定文本。 2. 如果指定一个字符串数组则创建动画逐帧显示数组里的文字图标， '\uF254'到'\uF250'的字符用于显示 FontAwesome 字体的沙漏动画。如果控件配置了 iconStyle 属性,则用图标属性（iconText）显示文字图标。字符串数组也可用 text 字段指定禁用状态显示的文本。 3. 此属性指定为 null 取消禁用并恢复控件禁用之前的 text、iconText 属性*/ ``` ### uiCtrlPlusObject.dlgCode # 用于指定响应 WM_GETDLGCODE 消息的默认代码。如果不指定则 plus 控件会自动选择适合的代码。可以显式指定为一个或多个 _DLGC_ 前缀常量组合（使用 `|` 操作符）的代码。例如 `1/*_DLGC_WANTARROWS*/` 以及 `4/*_DLGC_WANTALLKEYS*/`。注意只有 plus 控件可支持此属性。如果控件定义了 onGetDlgCode 事件函数则 dlgCode 属性无效。 ### uiCtrlPlusObject.dpiScale(x,y) # 将 @x,@y 表示的像素值乘以窗体当前 DPI 缩放倍数并返回, 省略 @y 参数时仅返回 @x 转换后的值 ### uiCtrlPlusObject.dpiScaleX # 窗口当前使用的 DPI 横坐标缩放系数, 该值由界面系统自动维护，任何情况下都不应手动修改, 这是一个以小数表示百分比的数，例如 1.25 表示 125%, 窗口未使用缩放或未完成缩放初始化时，值可能为 null，如果要获取屏幕缩放设置应改用 gdi.getDpiScale 函数 ### uiCtrlPlusObject.dpiScaleY # 窗口当前使用的 DPI 纵坐标缩放系数, 该值由界面系统自动维护，任何情况下都不应手动修改, 这是一个以小数表示百分比的数，例如 1.25 表示 125%, 窗口未使用缩放或未完成缩放初始化时，值可能为 null，如果要获取屏幕缩放设置应改用 gdi.getDpiScale 函数 ### uiCtrlPlusObject.drawToDevice(hdc,x,y) # 输出控件图像到hdc参数指定的GDI绘图设备, x,y为输出坐标,如果绘图到父窗口,x,y参数可省略 ### uiCtrlPlusObject.drawToGraphics(graphics,x,y) # 输出控件图像到hdc参数指定的GDI+画板, x,y为输出坐标,如果绘图到父窗口,x,y参数可省略 ### uiCtrlPlusObject.editBox # 文本编辑框,此文本框也是一个win.ui.tracker对象, [返回对象:richeditObject](#richeditObject) ### uiCtrlPlusObject.editState # 允许共享内部编辑框的外观状态,不指定默认值为true, 如果希望利用文本边距、前景边距等模拟分离按钮可将此值显示指定为false ### uiCtrlPlusObject.editable # 是否允许编辑文本如果此值设为true则切换到可编辑模式, 也可以指定要嵌入的编辑框的类名，例如"edit", 不指定类名则创建透明背景的richedit文本编辑框在首次切换到可编辑模式下创建文本框，并同步应用plus控件预设的字体、颜色、水平对齐方式，并使用plus控件预设的内边距限制文本编辑框显示范围。可使用editBox属性访问此文本编辑框，如果文本编辑框已创建，再次修改editable仅显示或隐藏文本编辑框 ### uiCtrlPlusObject.enableDpiScaling(false) # 禁用DPI自动缩放, 不指定参数启用DPI自动缩放,默认已启用 ### uiCtrlPlusObject.fitContent () # 控件调整大小调整到适应当前显示字数 ### uiCtrlPlusObject.focusOnClick # 设为 false 时禁止在单击控件时设置此控件为焦点控件 ### uiCtrlPlusObject.font # 控件字体（LOGFONT 结构体），注意获取该属性总是返回新的 LOGFONT 对象，修改返回字体并不会更新控件字体，除非重新赋值。建议尽量优先使用 getFont 或 setFont 函数，以增强代码可读性字体会根据控件设置自动处理 DPI 缩放，不需要事先缩放字体大小 ### uiCtrlPlusObject.fontCharMap # 指定自定义字符映射表, 键为字符,值为用于显示字符的gdip.bitmap对象如果指定了此属性则忽略字体大小,使用textPadding以及内边距限制输出大小 ### uiCtrlPlusObject.foreBottom # 前景图expand模式下九宫格切图的底部切线 ### uiCtrlPlusObject.foreLeft # 前景图expand模式下九宫格切图的左侧切线 ### uiCtrlPlusObject.foreRepeat # 前景显示模式支持模式expand,stretch,center,tile,scale 如果为null则foreLeft,foreRight为偏移坐标\expand模式foreTop,foreRight,foreBottom,foreLeft为九宫格切图坐标其他模式为显示边距 ### uiCtrlPlusObject.foreRight # 前景图expand模式下九宫格切图的右侧切线 ### uiCtrlPlusObject.foreTop # 前景图expand模式下九宫格切图的顶部切线如果控件显示为垂直滑块控件,此属性用于预留滑块按钮大小 ### uiCtrlPlusObject.foreground # 前景图像或前景色, 获取值是返回 gdip.bitmap 对象或 ARGB 格式颜色数值，赋值时可指定图像路径、资源路径、gdip.bitmap 对象、颜色值，颜色值使用0xAARRGGBB格式的数值。赋值时指定一个路径或资源路径控件将自动缓存使用频繁的图像内存图像建议使用setForeground函数指定缓存名如果边框圆角设为-1,前景图或前景色会裁剪为圆形后输出, [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.foregroundColor # 当前状态前景颜色, 修改背景色建议设置 foreground 属性为数值即可，直接修改 foregroundColor 不会释放之前的前景图像且不会重绘 ### uiCtrlPlusObject.getBackground() # 返回背景图像,返回值为gdip.bitmap对象此函数不会返回背景色，仅返回背景图像, 如果不存在背景图像返回null [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.getClientRect() # 控件客户区块位置(::RECT结构体) [返回对象:rectObject](https://www.aardio.com/zh-cn/doc/library-reference/global/_.html#rectObject) ### uiCtrlPlusObject.getFont() # 返回控件 LOGFONT 字体，返回对象的 h 值会按控件的 DPI 缩放设置自动还原为缩放前大小。 [返回对象:logfontObject](#logfontObject) ### uiCtrlPlusObject.getFont(true) # 返回控件 LOGFONT 字体，返回对象的 h 值为字体实际大小，不会按控件 DPI 设置还原。返回字体会设置 noScale 属性为 true, 使用控件的 setFont 函数或赋值 font 属性时， noScale 属性为 true 的字体同样不会进行自动 DPI 缩放 [返回对象:logfontObject](#logfontObject) ### uiCtrlPlusObject.getFontEx() # 返回gdip.font字体注意字体生命期由控件管理 [返回对象:gdipfontObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/font.html#gdipfontObject) ### uiCtrlPlusObject.getForeground() # 返回前景图像,返回值为gdip.bitmap对象此函数不会返回前景色，仅返回前景图像, 如果不存在前景图像返回null [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.getForm() # 标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。 win.form 创建的窗体对象返回自身，其他控件对象返回创建控件的容器窗口（ _parentForm 属性） ### uiCtrlPlusObject.getParent() # 返回父窗口 ### uiCtrlPlusObject.getPos() # 返回相对父窗口客户区的坐标,宽,高, 参数为true返回屏幕坐标,宽,高, x,y,cx,cy=win.getPos(hwnd) ### uiCtrlPlusObject.getProgressRange() # 返回进度条最小值,最大值 ### uiCtrlPlusObject.getRect() # 控件区块位置(::RECT结构体) ### uiCtrlPlusObject.getRect(true) # 控件屏幕区块位置(::RECT结构体) ### uiCtrlPlusObject.getRoot() # 获取顶层父窗口，这个函数会查找 orphanWindow 的父窗口 ### uiCtrlPlusObject.getScale() # 返回 X 轴、Y 轴方向缩放比例，DPI 缩放比例共 4 个返回值, scaleX,scaleY,dpiScaleX,dpiScale 。 win.ui 创建的所有窗体与控件对象都提供此方法。 ### uiCtrlPlusObject.height # 高度 ### uiCtrlPlusObject.hide # 当前控件窗口是否隐藏。仅检查当前窗口的可见性样式（窗口是否移除了 _WS_VISIBLE 样式）。不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。 ### uiCtrlPlusObject.hotkeyPrefix # ```aardio uiCtrlPlusObject.hotkeyPrefix = _GdipHotkeyPrefixShow; ``` ### uiCtrlPlusObject.hwnd # 控件句柄 ### uiCtrlPlusObject.iconColor # 字体图标颜色，支持半透明。支持使用 skin 函数动态切换此样式, 此颜色值在运行时使用 ARGB 格式，即:0xAARRGGBB，在创建控件的初始化参数中则必须指定 0xBBGGRR 格式颜色值。请注意在未指定指属性时，图标字体默认与字体使用相同的颜色 ### uiCtrlPlusObject.iconFont # 图标字体，LOGFONT 结构体。获取值时，如果存在 iconStyle.font，直接返回 iconStyle.font。对 iconFont 赋值总是会创建新的 LOGFONT 结构并存为 iconStyle.font 使用 iconFont 赋值时可以传入仅指定 LOGFONT 部分成员的普通表。修改返回字体的成员不会更新 plus 控件实际使用的 GDI+ 字体。只有重新对 iconFont 赋值，才会在下次重绘时刷新 GDI+ 字体图标字体会根据控件设置自动处理 DPI 缩放，不需要事先缩放字体大小 [返回对象:logfontObject](#logfontObject) ### uiCtrlPlusObject.iconStyle # ```aardio uiCtrlPlusObject.iconStyle = { font=LOGFONT(h=-38;name='FontAwesome'); align="left";valign="top";padding={bottom=50}/*用于指定 iconText 显示样式如 font 指向控件已使用的 iconStyle.font，则控件不会刷新字体。 font 如不是 ::LOGFONT 字体，控件将自动转换为 ::LOGFONT 字体。对 iconFont 属性赋值以修改 iconStyle.font 则总是会刷新字体*/ } ``` ### uiCtrlPlusObject.iconText # 指定文本图标使用iconStyle指定字体与样式 ### uiCtrlPlusObject.iconTextRenderingHint # ```aardio uiCtrlPlusObject.iconTextRenderingHint = _GdipTextRenderingHint; ``` ### uiCtrlPlusObject.id # 控件ID ### uiCtrlPlusObject.imageAttributes # 可选使用一个gdip.imageAttributes对象对前景图像进行自动调色如果需要在不同状态下调色,可以在onStateChange事件里动态设置调色矩阵 [返回对象:gdipImgattrObject](#gdipImgattrObject) ### uiCtrlPlusObject.interpolationMode # 图像缩放时的默认插值模式, 默认值为_GdipInterpolationModeHighQualityBicubic ### uiCtrlPlusObject.invalidate(/*可选使用::RECT()对象指定客户区*/) # 使窗口绘图区无效 ### uiCtrlPlusObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) # 使窗口绘图区无效不刷新背景 ### uiCtrlPlusObject.isDialogMessage # ```aardio uiCtrlPlusObject.isDialogMessage = function(hParent,msg){/*在控件范围内替代父窗口的 isDialogMessage，可用于在控件范围内屏蔽对话框快捷键*/} ``` ### uiCtrlPlusObject.isForm # 标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。 win.form 创建的窗体对象返回 true,其他控件对象返回 false 。 ### uiCtrlPlusObject.isHyperlink() # 是否超链接模式（非禁用状态下鼠标指针显示为手形）。设为此模式的控件的 mode 属性值为 "hyperlink"。可在创建控件的表参数中指定 `mode = "hyperlink"`以切换到超链接模式。当调用 skin 函数设置样式时，如果未指定 mode 属性、cursor 属性、背景、前景、边框、iconText，并且仅指定了文本非空，则默认设为超链接模式。 ### uiCtrlPlusObject.left # 左侧坐标 ### uiCtrlPlusObject.linearGradient # 数值,指定背景色线性渐变的角度, 渐变从背色颜色开始,到前景颜色结束只有背景、前景都指定了当前状态下的颜色值才有效, 270,90为垂直方向的渐变 180,360为水平方向的渐变此属性指定为负数启用圆形径向渐变,此时background为中心颜色，foreground为环绕颜色 ### uiCtrlPlusObject.measureString() # 返回文本输出后的区块大小,返回值为 RECTF 对象可选在参数中指定要输出的文本,不指定则取当前显示文本, [返回对象:rectfObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/core.html#rectfObject) ### uiCtrlPlusObject.messageOnly() # 将窗口转换为message-only window 该窗口不可见,仅用于消息分发 ### uiCtrlPlusObject.modifyStyle(remove,add,swpFlags) # 修改窗口样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### uiCtrlPlusObject.modifyStyleEx(remove,add,swpFlags) # 修改窗口扩展样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### uiCtrlPlusObject.msgAsk(text) # 显示询问提示框。参数 @text 指定要显示的文本信息。用户按确定或回车返回 true ，其他返回 false 或 null 。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgErr(text,timeout) # 显示错误提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgFrown(text,timeout) # 显示皱眉图标提示框。参数 @text 指定要显示的文本信息。可选用参数 @2 指定延时关闭的毫秒数, 请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgGreat(text,timeout) # 显示竖大拇指图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgInfo(text,timeout) # 显示提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgOk(text,timeout) # 显示正确提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgSmile(text,timeout) # 显示微笑图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.msgWarn(text,timeout) # 显示警告提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.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 限定显示时间，以毫秒为单位，超时自动关闭。 ### uiCtrlPlusObject.msgboxErr(text,title) # 弹出错误对话框参数 @text 指定显示的信息，如果指定表对象先序列化为文本。其他对象调用 tostring 转换为文本可选参数 @title 用于指定信息框标题。此函数调用 win.msgbox，并设定所有者窗口为当前窗体。 ### uiCtrlPlusObject.msgboxTest(text,title) # 弹出询问对话框参数 @text 指定显示的信息，如果指定表对象先序列化为文本。其他对象调用 tostring 转换为文本可选参数 @title 用于指定信息框标题。此函数调用 win.msgbox，并设定所有者窗口为当前窗体。 ### uiCtrlPlusObject.notify # 是否启用事件回调。设为 false 将不能响应鼠标按键等交互事件。调用 skin,setTrackbarRange 等方法或者添加 oncommand,onMouseMove ,onMouseDown,onMouseClick,onKeyDown 事件时会自动启用此属性。 ### uiCtrlPlusObject.oncommand # ```aardio uiCtrlPlusObject.oncommand = function( id,event ){ /*控件被单击*/ } ``` ### uiCtrlPlusObject.onnotify # ```aardio uiCtrlPlusObject.onnotify = function(id,code,ptr){ /*处理通知消息, plus 控件默认不发送通知消息, 但如果绑定 tooltip 控件这些会触发这个事件*/ } ``` ### uiCtrlPlusObject.orphanWindow # 如果当前是子窗口, 移除窗口的WS_CHILD样式，使窗口孤立出来悬浮于原位置, 悬浮窗口如影随形的跟随父窗口移动或改变大小,控件原来的固定边距等参数仍然有效 ### uiCtrlPlusObject.orphanWindow(transparent,hwndBuddy) # 创建悬浮窗口, 悬浮窗口仍然显示在原来的位置, 可选参数 @transparent 如果为 true 则转换为分层透明窗口, 可选利用 @buddy 参数将只有句柄的窗口托管在悬浮窗口之上实现相同的效果, 伙伴窗口总是会保持在悬浮窗口前面，并保持相同的大小、位置 ### uiCtrlPlusObject.padding # ```aardio uiCtrlPlusObject.padding = { left = 0; top = 0; bottom = 0; right = 0;/*指定前景边距，限制前景与文本区边距。文本区可使用 textPadding 再次叠加边距。*/ } ``` ### uiCtrlPlusObject.paddingBottom # 前景下边距可限制前景以及文本,文本还可以使用textPadding属性进一步增减边距滑块模式下,此属性将同时作用于背景色，作不会作用于背景图像 ### uiCtrlPlusObject.paddingLeft # 前景左边距可限制前景以及文本,文本还可以使用textPadding属性进一步增减边距滑块模式下,此属性将同时作用于背景色，作不会作用于背景图像 ### uiCtrlPlusObject.paddingRight # 前景右边距可限制前景以及文本,文本还可以使用textPadding属性进一步增减边距滑块模式下,此属性将同时作用于背景色，作不会作用于背景图像 ### uiCtrlPlusObject.paddingTop # 前景上边距可限制前景以及文本,文本还可以使用textPadding属性进一步增减边距滑块模式下,此属性将同时作用于背景色，作不会作用于背景图像 ### uiCtrlPlusObject.passwordChar # 指定隐藏密码的占位字符, 例如指定为"*"隐藏密码,指定为null正常显示文本如果调用了setCueBannerText，passwordChar不会影响提示文本 ### uiCtrlPlusObject.postMessage(msg,wParam,lParam) # 投递窗口消息到消息队列中此函数用法请参考 ::User32.PostMessage ### uiCtrlPlusObject.preadjust # ```aardio uiCtrlPlusObject.preadjust = function( cx,cy,wParam ) { /*窗口缩放后重绘前、触发 adjust 事件之前触发此事件。所有 win.form 创建的窗体和控件都支持此事件, 与 adjust 事件不同，对 preadjust 重复赋值则覆盖而不是追加事件。 cx 参数为窗口宽度,cy 参数为窗口高度, wParam 为 _WM_SIZE 消息参数。*/ }; ``` ### uiCtrlPlusObject.predraw() # 刷新位图缓存并准备下次重绘 ### uiCtrlPlusObject.progressPercentage # 进度条当前百分比。如果用户正在控件上按下鼠标（例如拖动滑块），设置此属性会被忽略 ### uiCtrlPlusObject.progressPos # 获取或设置进度条当前值。如果用户正在控件上按下鼠标（例如拖动滑块），设置此属性会被忽略 ### uiCtrlPlusObject.publish("字符串参数",) # 在窗口所在界面线程发布消息, 运行界面线程所有所有调用subscribe函数订阅此消息的函数, 可添加任意个触发参数 ### uiCtrlPlusObject.radioClick() # 单选模式下选中控件 ### uiCtrlPlusObject.radioGroup # 用于指定单选按钮分组名称。也可以在 skin 函数参数表的 group 字段中指定此属性值。 ### uiCtrlPlusObject.radioValue() # 单选模式下选中控件的文本 ### uiCtrlPlusObject.redraw() # 刷新重绘，默认不重绘背景。如果控件未指定 background 或 backgroundColor 属性但启用了“剪切背景”属性（默认设置）仍然会重绘背景。 ### uiCtrlPlusObject.redrawTransparent() # 刷新重绘如果控件添加了透明样式 _WS_EX_TRANSPARENT 则重绘窗口背景 ### uiCtrlPlusObject.reduce(array,callback,debounce) # ```aardio uiCtrlPlusObject.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; } } ) ``` ### uiCtrlPlusObject.reloadScale() # 按设计时位置参数、重新调整控件位置以适应窗口当前缩放比例。父窗口缩放时会自动执行此操作。默认在启动窗口消息循环时会自适应调整所有控件。所以在启动消息循环前添加控件不必调用此函数。 ### uiCtrlPlusObject.repeat # 背景显示模式支持模式expand,stretch,center,tile,scale\expand模式foreTop,foreRight,foreBottom,foreLeft为九宫格切图坐标其他模式为显示边距 ### uiCtrlPlusObject.resize(宽度,高度) # 如果指定了参数则调整窗口大小, 无论是否实际调整窗口大小,发送 _WM_SIZE 消息给窗口 ### uiCtrlPlusObject.right # 右侧坐标 ### uiCtrlPlusObject.saveScale() # 根据控件当前位置、缩放比例，更新控件的设计时位置参数。以避免下次窗口缩放自适应调整控件当前位置更改被清除，控件所有调整位置的属性或成员函数已自动调用此函数。 ### uiCtrlPlusObject.sendMessage(msg,wParam,lParam) # 发送窗口消息此函数用法请参考 ::User32.SendMessage ### uiCtrlPlusObject.setBackground # 修改背景图像 ### uiCtrlPlusObject.setBackground() # [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.setBackground(背景图像,false) # 加载背景图像并禁用缓存该函数设置成功返回原来的背景图（gdip.bitmap 对象） ### uiCtrlPlusObject.setBackground(背景图像,缓存名,刷新重绘) # 参数@1也可以使用0xAARRGGBB格式的数值指定一个颜色值, 缓存名为可选参数,默认以路径为缓存名,设为false禁止缓存, 如果参数@1是图像数据则可以使用参数@2指定缓存名刷新重绘参数@3默认为true 该函数设置成功返回原来的背景图（gdip.bitmap 对象） ### uiCtrlPlusObject.setCueBannerText # 并且指定嵌入编辑框为空时的显示的默认提示文本嵌入richedit时调用此函数会阻止拖放文件消息, 嵌入编辑框改为edit即可 ### uiCtrlPlusObject.setCueBannerText("提示文本") # 打开编辑模式, 并且指定文本为空时的显示的默认提示文本注意指定提示文本以后, 不应再直接访问editBox的text,passwordChar属性, 请改为读写plus控件的text,passwordChar属性 ### uiCtrlPlusObject.setFocus() # 设置焦点可选在参数中指定新的控件文本如果启用了编辑模式,此函数将光标移动文本尾部 ### uiCtrlPlusObject.setFont(指定字体) # 指定 LOGFONT 字体对象,或逻辑字体句柄如果不指定 point 值并指定 h 值，字体会按控件的 DPI 缩放设置自动缩放。 ### uiCtrlPlusObject.setFont(混入字体属性) # ```aardio uiCtrlPlusObject.setFont(h=-12;name="Tahoma"); ``` ### uiCtrlPlusObject.setFontEx(字体) # 设置gdip.font字体字体由控件接管并负责释放 ### uiCtrlPlusObject.setForeRepeat("模式",是否重绘) # 修改前景显示模式支持模式expand,stretch,center,tile,scale ### uiCtrlPlusObject.setForeground # 修改前景图像 ### uiCtrlPlusObject.setForeground() # [返回对象:gdipbitmapObject](https://www.aardio.com/zh-cn/doc/library-reference/gdip/bitmap.html#gdipbitmapObject) ### uiCtrlPlusObject.setForeground(前景图像,缓存名,刷新重绘) # 修改前景图像参数@1也可以使用0xAARRGGBB格式的数值指定一个颜色值, 缓存名为可选参数,默认以路径为缓存名,设为false禁止缓存, 如果参数@1是图像数据则可以使用参数@2指定缓存名刷新重绘参数@3默认为true 该函数设置成功返回原来的前景图图（gdip.bitmap 对象） ### uiCtrlPlusObject.setForeground(背景图像,false) # 加载前景图像并禁用缓存该函数设置成功返回原来的背景图（gdip.bitmap 对象） ### uiCtrlPlusObject.setForeground(颜色数值) # 修改foregroundColor的值注意plus控件、GDI+都是ARGB格式数值表示颜色分量,即:0xAARRGGBB 与RGB的分量顺序是反过来的 ### uiCtrlPlusObject.setInterval(回调函数,延时毫秒数,...) # ```aardio uiCtrlPlusObject.setInterval(回调函数,延时毫秒数,...setInterval( function(){ /*参数@1指定执行函数,参数@2指定执行间隔，可选指定一个或多个回调参数，不指定回调参数则默认为: hwnd,message,timerId,tick, 如果在定时器中执行了win.delay等继续消息循环的代码，在定时器退出前不会再触发同一定时器（重入）。定时器回调函数返回数值可修改时间间隔, 返回false取消该定时器*/ },1000 ) ``` ### uiCtrlPlusObject.setParent(控件对象) # 改变父窗口 ### uiCtrlPlusObject.setPieRange # 设置扇形进度条范围。 ### uiCtrlPlusObject.setPieRange(min,max,cutoutPercentage) # 切换为扇形进度条模式。在此模式下前景图或前景色被裁剪为扇形。如果有背景色则被裁剪为圆角，背景图不裁剪。如果指定背景图、前景图,应设为 center 显示模式以使圆心对齐。 - 参数 @min,@max 指定最小、最大进度值。 - 可选参数 @cutoutPercentage 用于指定抠除的中心圆百分比（圆环效果）。 @cutoutPercentage 可选指定 0~100 之间的数值。 ### uiCtrlPlusObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) # 调整窗口位置或排序,所有参数可选同时指定x,y坐标则移动位置同时指定宽高则改变大小指定插入位置(句柄或_HWND前缀常量)则调整Z序 ### uiCtrlPlusObject.setProgressRange # 设置进度条范围，并切换到进度条显示模式。如果宽大于高显示为水平进度条，高大于宽则显示为垂直进度条。调用了此函数将会强制使用expand显示模式水平进度条文本右对齐,垂直进度条文本上对齐时将限制文本输出于前景内部否则不改变文本输出位置可选用textPadding属性指定文本内边距 ### uiCtrlPlusObject.setProgressRange(最小值,最大值) # 设置进度条范围。调用了此函数将会强制使用 expand 显示模式。如果在调用 startProgress,stepProgress 等方法或修改 progressPos 属性时尚未设置进度条范围，则会自动调用此函数并设置最小最大值为 0,100。 ### uiCtrlPlusObject.setRect(rc) # 设置控件区块位置(::RECT结构体) ### uiCtrlPlusObject.setRect(rc,true) # 设置控件屏幕区块位置(::RECT结构体) ### uiCtrlPlusObject.setRedraw(false) # 禁止重绘 ### uiCtrlPlusObject.setRedraw(true) # 恢复重绘 ### uiCtrlPlusObject.setRepeat("模式",是否重绘) # 修改背景显示模式支持模式expand,stretch,center,tile,scale ### uiCtrlPlusObject.setTimeout(函数或代码,延时,其他附加参数) # 推迟执行指定的函数或代码此函数异步执行参数中指定的函数，不会阻塞当前代码继续执行，延时参数是可选参数，以毫秒为单位，默认为0毫秒可选用附加参数指定调用延时函数的实参返回值为定时器ID ### uiCtrlPlusObject.setTrackbarRange # 设置滑块范围，并切换到滑块显示模式。如果宽大于高显示为水平滑块，高大于宽则显示为垂直滑块。用户拖动滑块时触发 onPosChanged 事件，可用于获取当前位置 ### uiCtrlPlusObject.setTrackbarRange(最小值,最大值) # 如果使用图像制作滑块控件, 请将背景、前景图像设为九宫格拉伸的expand模式, 使用前景切图在右侧或顶部预留滑块位置不拉伸, 如果未指定前景图像,aardio将自动使用当前字体颜色绘制滑块按钮, 同样通过前景切图预留滑块大小,边框圆角属性将作用于滑块按钮, 前景色将用于绘制滑块左侧或底部,背景色将用于绘制滑块右侧或顶部, 前景边距将同时限制背景前景色的大小，但不会作用于背景图像 ### uiCtrlPlusObject.sgSorry(text,timeout) # 显示倒竖大拇指图标提示框。参数 @text 指定要显示的文本信息。可选使用参数 @timeout 指定延时自动关闭提示框的毫秒数。请先导入 win.dlg.message 库以安装此函数 ### uiCtrlPlusObject.show(true) # 显示控件 ### uiCtrlPlusObject.skin(styleTable,clone) # ```aardio uiCtrlPlusObject.skin({ background = { default = 0xFF007BFF; hover = 0xFF2B89ED; active = 0xFF0062CC; disabled = 0xFFCCCCCC; }; color={ default=0xFFFFFFFF; disabled=0xFF6D6D6D }; })/*配置 plus 控件在不同交互状态下的外观样式。 skin 可作为方法调用，也可作为属性使用（读写当前外观方案）。用法请查看 plus 控件使用指南。*/ ``` ### uiCtrlPlusObject.smoothingMode # 绘图画布默认抗锯齿模式, 默认值为_GdipSmoothingModeAntiAlias ### uiCtrlPlusObject.startAnimation # 启动动画定时器，立即运行一次动画并且定时继续运行动画。此函数负责定时调用 onAnimation 并且定时重绘控件外观。可选在控件的 onAnimation 动画事件函数中修改外观，或者在控件的 onDrawContent 等绘图事件函数中直接输出动画。 ### uiCtrlPlusObject.startAnimation(interval,beginning,change,duration) # 创建动画，定时执行 onAnimation 动画事件回调函数并重绘控件。调用此函数后立即运行一次动画，然后定时运行动画。参数 @interval 指定动画时间间隔，以毫秒为单位。参数 @beginning 指定初始状态值，不指定则默认为 0。可选参数 @change 指定动画完成后的状态值。可选参数 @duration 指定动画持续时间除参数 @interval 以外的参数会传给 onAnimation 回调函数作为调用参数。 ### uiCtrlPlusObject.startProgress() # 启动进度条动画,并显示进度条。如果尚未设置进度范围则会自动设置并切换到进度条模式。可选用参数 @1 指定间隔毫秒,可选用参数 @2 指定每次推进的进度。必须先调用 setProgressRange 函数事先指定进度范围。必须指定前景色、或前景图 ### uiCtrlPlusObject.stepProgress # 增加进度条的值。 ### uiCtrlPlusObject.stepProgress(步进单位,是否刷新) # 步进单位可以省略,默认为1 参数@2可省略,默认为true 进度条到尾部或头部则返回false,否则返回true ### uiCtrlPlusObject.stopAnimation() # 停止动画定时器 ### uiCtrlPlusObject.stopProgress() # 停止进度条动画,并隐藏进度条 ### uiCtrlPlusObject.stringFormatFlags # ```aardio uiCtrlPlusObject.stringFormatFlags = _GdipStringFormatFlagsMeasureTrailingSpaces; ``` ### uiCtrlPlusObject.tabNext() # [返回对象:staticObject](https://www.aardio.com/zh-cn/doc/library-reference/win/ui/ctrl/static.html#staticObject) ### uiCtrlPlusObject.tabNext(移动焦点,是否反向) # 获取下一个支持tab控制焦点的控件参数@1为true会自动移动焦点到该控件参数@2为true则获取上一个控件,否则获取下一个控件 ### uiCtrlPlusObject.text # 控件文本 ### uiCtrlPlusObject.textPadding # ```aardio uiCtrlPlusObject.textPadding = { left = 0; top = 0; bottom = 0; right = 0;/*指定文本区输出内边距,在前景内边距上叠加,可以使用负数,仅对文本有效*/ } ``` ### uiCtrlPlusObject.textRenderingHint # ```aardio uiCtrlPlusObject.textRenderingHint = _GdipTextRenderingHint; ``` ### uiCtrlPlusObject.theme # 外观主题,例如 winform.button.theme = "Explorer" winform.button.theme = false ### uiCtrlPlusObject.threadCallable() # 开启此控件的跨线程调用功能 ### uiCtrlPlusObject.toClient(x,y) # 将参数 x,y 指定的屏幕坐标转换为当前控件客户区坐标。返回 2 个值：x,y ### uiCtrlPlusObject.toScreen(x,y) # 将参数 x,y 指定的当前控件客户区坐标转换为屏幕坐标。返回 2 个值：x,y ### uiCtrlPlusObject.top # 顶部坐标 ### uiCtrlPlusObject.translateAccelerator # ```aardio uiCtrlPlusObject.translateAccelerator = function(msg){ /*返回是否快捷键*/ } ``` ### uiCtrlPlusObject.translateCommand() # 允许转发转发子窗口的命令（_WM_COMMAND）与通知（_WM_NOTIFY）消息，避免子窗口 oncommand，onnotify 等回调失效。同时会处理子窗口的 _WM_CTLCOLORSTATIC 等消息，以避免部分外观属性失。启用嵌入编辑框功能时已自动调用此函数 ### uiCtrlPlusObject.trimming # ```aardio uiCtrlPlusObject.trimming = _GdipStringTrimming; ``` ### uiCtrlPlusObject.tryCreateEmbed # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象。通常使用 util.metaProperty 为容器对象添加属性元表，属性元表可拦截属性、函数调用并调用 _object 对象, createEmbedEx 返回的容器已添加默认代理以直接访问 COM 对象 ### uiCtrlPlusObject.tryCreateEmbed() # [返回对象:embedObject](https://www.aardio.com/zh-cn/doc/library-reference/com/_.html#embedObject) ### uiCtrlPlusObject.tryCreateEmbed(clsId,embedObj) # 创建嵌入控件,返回控件容器对象, 容器对象的 _object 成员是创建的 COM 对象, 容器对象可通过添加成员函数响应 COM 对象事件，容器对象的主要作用是充当访问 COM 对象的中间代理对象, @clsId 指定控件 CLSID, 可选在参数@2中指定 COM 对象绑定的容器对象成功返回容器对象,失败返回false,错误信息 ### uiCtrlPlusObject.update() # 重绘invalidate函数指定的区块 ### uiCtrlPlusObject.valid # 窗口是否有效，窗口未关闭返回 true ，窗口已关闭或正在关闭返回 false ### uiCtrlPlusObject.valign # 文本垂直对齐, 顶对齐："top" 居中："center" 底对齐："bottom" 图标文本对齐请使用 iconStyle 属性的 align 字段指定垂直对齐 ### uiCtrlPlusObject.value # 控件文本，text 属性的别名。 ### uiCtrlPlusObject.width # 宽度 ### uiCtrlPlusObject.x # 前景x坐标,仅用于point绘图模式, 1、0到1之间的小数表示百分比，负数表示右侧反向坐标 ### uiCtrlPlusObject.y # 前景y坐标,仅用于point绘图模式, 1、0到1之间的小数表示百分比，负数表示底部反向坐标 ## uiCtrlPlusObject 事件列表 # ### uiCtrlPlusObject.onAnimation(state,beginning,change,timestamp,duration) # ```aardio uiCtrlPlusObject.onAnimation = function(state,beginning,change,timestamp,duration){ /*startAnimation 函数启动的动画将定时回调此函数。参数 @state 是上次返回的值。可以使用 plus 控件的 animationState 属性获取 @state 最新的值。参数 @timestamp 为动画已执行的时间其他参数为调用 startAnimation 指定的参数, 返回值恒等于 null 则停止动画，返回其他值继续执行动画。*/ return state; } ``` ### uiCtrlPlusObject.onContextMenu # ```aardio uiCtrlPlusObject.onContextMenu = function(x,y){ /*请求显示右键菜单（单击鼠标右键、菜单键或按下 Shift+F10。参数 x,y 为鼠标当前所在的屏幕坐标*/ } ``` ### uiCtrlPlusObject.onDrawBackground # ```aardio uiCtrlPlusObject.onDrawBackground = function(graphics,rc,backgroundColor,foregroundColor){ /*自绘背景, graphics 为gdip.graphics对象(GDI+画板), rc为绘图区块, bkColor为当前状态背景色,AGGB格式,可能为null foreColor为当前状态前景色,ARGB格式,不会出现null值返回真取消默认的背景绘图*/ } ``` ### uiCtrlPlusObject.onDrawContent # ```aardio uiCtrlPlusObject.onDrawContent = function(graphics,rc,txtColor,rcContent,foregroundColor,font){ /*自绘前景, graphics 为gdip.graphics对象（GDI+画板）, txtColor 为文本色,ARGB 格式（0xAARRGGBB）数值, foreColor 为当前状态前景色,ARGB 格式数值, rc为客户区RECT结构体,rcContent为去掉内边距后的 RECT 结构体, 返回真则取消绘制默认前景的操作（包含进度条、滑块等涉及前景绘制的操作）。*/ } ``` ### uiCtrlPlusObject.onDrawEnd # ```aardio uiCtrlPlusObject.onDrawEnd = function(graphics,rc,bmpMem){ /*所有绘制操作结束触发此事件, graphics 为gdip.graphics对象(GDI+画板), rc 为客户区RECT结构体, bmpMem 为当前正在绘制的 gdip.bitmap 对象，要注意此函数退出后不可继续使用 bmpMem，可使用 bmpMem.clone,bmpMem.copy,bmpMem.getThumbnail 等复制图像*/ } ``` ### uiCtrlPlusObject.onDrawForegroundEnd # ```aardio uiCtrlPlusObject.onDrawForegroundEnd = function(graphics,rc,rcContent){ /*背景前景绘制后,绘制文本前触发此事件, graphics 为gdip.graphics对象(GDI+画板), rc为客户区RECT结构体,rcContent为去掉内边距后的RECT结构体*/ } ``` ### uiCtrlPlusObject.onDrawString # ```aardio uiCtrlPlusObject.onDrawString = function(graphics,text,font,rectf,strformat,brush){ /*自定义输出文本,请不要删除传入参数中的GDI+对象*/ graphics.drawString(text,font,rectf,strformat,brush); } ``` ### uiCtrlPlusObject.onDropFiles # ```aardio uiCtrlPlusObject.onDropFiles = function(files){ /*接受系统拖放,files是拖放的所有文件路径名数组,嵌入编辑框必须是edit控件,richedit*/ } ``` ### uiCtrlPlusObject.onFocusGot(hLostFocus) # ```aardio uiCtrlPlusObject.onFocusGot = function(hLostFocus){ ..win.setFocus(hLostFocus);/*得到焦点触发此事件,hLostFocus为失去焦点的窗口句柄, 如果在这里将hLostFocus恢复焦点,则阻止当前窗口得到焦点*/ } ``` ### uiCtrlPlusObject.onFocusLost(hFocus) # ```aardio uiCtrlPlusObject.onFocusLost = function(hFocus){ /*失去焦点触发此事件,hFocus为得到焦点的窗口句柄*/ } ``` ### uiCtrlPlusObject.onGetDlgCode # ```aardio uiCtrlPlusObject.onGetDlgCode = function(keyCode,pMsg){ return _DLGC_/*自定义收到 _WM_GETDLGCODE 查询消息的响应代码。返回值可以是一个或多个 _DLGC_ 前缀常量的组合。例如可以返回 4/*_DLGC_WANTALLKEYS*/ 以允许控件处理所有按键消息。如果未定义 onGetDlgCode 函数则会返回 dlgCode 属性指定的代码。如果也未指定 dlgCode 属性则根据 notify 属性自动选择返回代码。仅 plus 控件支持此事件。 */; } ``` ### uiCtrlPlusObject.onKeyDown # ```aardio uiCtrlPlusObject.onKeyDown = function(keyCode,lParam,repeat){ /*按下键盘键*/ } ``` ### uiCtrlPlusObject.onKeyUp # ```aardio uiCtrlPlusObject.onKeyUp = function(keyCode,lParam){ /*放开键盘键*/ } ``` ### uiCtrlPlusObject.onMiddleMouseDown # ```aardio uiCtrlPlusObject.onMiddleMouseDown = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标中键按下*/ } ``` ### uiCtrlPlusObject.onMiddleMouseUp # ```aardio uiCtrlPlusObject.onMiddleMouseUp = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标中键弹起*/ } ``` ### uiCtrlPlusObject.onMouseActivate # ```aardio uiCtrlPlusObject.onMouseActivate = function(hwndTop,hitTest,message){ return _MA_/*鼠标点击并且将要激活窗口时触发此事件 hwndTop表示被激活的顶层窗口, hitTest参数请参考WM_NCHITTEST消息 message为鼠标消息ID 返回值的作用请参数MSDN*/ } ``` ### uiCtrlPlusObject.onMouseClick # ```aardio uiCtrlPlusObject.onMouseClick = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标左键在控件上单击, orphanWindow模式下如果阻止控件得到焦点,此事件不会被触发*/ } ``` ### uiCtrlPlusObject.onMouseDoubleClick # ```aardio uiCtrlPlusObject.onMouseDoubleClick = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标左键双击*/ } ``` ### uiCtrlPlusObject.onMouseDown # ```aardio uiCtrlPlusObject.onMouseDown = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标左键按下, orphanWindow模式下如果阻止控件得到焦点,此事件不会被触发*/ } ``` ### uiCtrlPlusObject.onMouseDrag # ```aardio uiCtrlPlusObject.onMouseDrag = function(wParam,lParam){ /*鼠标左键按下拖动, 自动捕获鼠标,允许拖出控件范围*/ } ``` ```aardio uiCtrlPlusObject.onMouseDrag = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标左键按下拖动, 自动捕获鼠标,允许拖出控件范围*/ } ``` ### uiCtrlPlusObject.onMouseEnter # ```aardio uiCtrlPlusObject.onMouseEnter = function(wParam,lParam){ /*鼠标移入*/ } ``` ### uiCtrlPlusObject.onMouseHWheel # ```aardio uiCtrlPlusObject.onMouseHWheel = function(flags,delta,lParam){ delta = -delta/(120/3); /*水平滚动鼠标滚轮,flags 参数以 _MK_CONTROL 等常量表示按键*/ } ``` ### uiCtrlPlusObject.onMouseHover # ```aardio uiCtrlPlusObject.onMouseHover = function(wParam,lParam){ /*鼠标悬停*/ } ``` ### uiCtrlPlusObject.onMouseLeave # ```aardio uiCtrlPlusObject.onMouseLeave = function(wParam,lParam){ /*鼠标移出*/ } ``` ### uiCtrlPlusObject.onMouseMove # ```aardio uiCtrlPlusObject.onMouseMove = function(wParam,lParam){ if( wParam & 0x1/*_MK_LBUTTON*/ ){ var x,y = win.getMessagePos(lParam); /*鼠标移动*/ } } ``` ### uiCtrlPlusObject.onMouseUp # ```aardio uiCtrlPlusObject.onMouseUp = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标左键弹起*/ } ``` ### uiCtrlPlusObject.onMouseWheel # ```aardio uiCtrlPlusObject.onMouseWheel = function(flags,delta,lParam){ delta = delta/(120/3); /*滚动鼠标滚轮,flags 参数以 _MK_CONTROL 等常量表示按键*/ } ``` ### uiCtrlPlusObject.onPosChanged # ```aardio uiCtrlPlusObject.onPosChanged = function( pos,triggeredByUser ){ /*进度值变更,pos 参数为当前进度数值, 如果此事件由用户拖动滑块或按键盘方向键触发,则 triggeredByUser 参数为 true*/ } ``` ### uiCtrlPlusObject.onRightMouseDown # ```aardio uiCtrlPlusObject.onRightMouseDown = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标右键按下*/ } ``` ### uiCtrlPlusObject.onRightMouseUp # ```aardio uiCtrlPlusObject.onRightMouseUp = function(wParam,lParam){ var x,y = win.getMessagePos(lParam); /*鼠标右键弹起*/ } ``` ### uiCtrlPlusObject.onSelectChange # ```aardio uiCtrlPlusObject.onSelectChange = function(prev,current){ /*单选模式下已选中当前控件,prev 为同一分组之前选中的控件。同一分组之前没有选中控件时 prev 为 null 。 current 为当前选中控件。*/ } ``` ### uiCtrlPlusObject.onSize # ```aardio uiCtrlPlusObject.onSize = function( width,height,wParam ) { /*父窗口改变大小后会自动触发此事件函数。注意 onSize 是 adjust 事件的别名，作用相同所有 win.form 创建的窗体和控件都支持 onSize（或 adjust）事件, 重复赋值 onSize（或 adjust）会追加事件触发器而非替换原来的值。 width 参数为窗口客户区宽度,height 参数为窗口客户区高度, wParam 参数来自 _WM_SIZE 消息的 wParam 参数，一般不用管。一般不建议添加一个 wndproc 仅仅是为了处理 _WM_SIZE 消息，定义 onSize 事件是更好的选择。 };*/ ``` ### uiCtrlPlusObject.onStateChange # ```aardio uiCtrlPlusObject.onStateChange = function(state){ /*状态已改变*/ } ``` ### uiCtrlPlusObject.onSysKeyDown # ```aardio uiCtrlPlusObject.onSysKeyDown = function(keyCode,lParam,repeat){ if(keyCode!=0x12/*_VK_ALT*/){ /*按下键盘ALT组合键*/ } } ``` ### uiCtrlPlusObject.onSysKeyUp # ```aardio uiCtrlPlusObject.onSysKeyUp = function(keyCode,lParam){ /*放开键盘键*/ } ``` ## uiCtrlPlusObject.state 成员列表 # ### uiCtrlPlusObject.state.active # 鼠标或键盘键按下状态注意直接修改该状态控件不负责重绘 ### uiCtrlPlusObject.state.checked # 是否选中状态注意直接修改该状态控件不负责重绘 ### uiCtrlPlusObject.state.disabled # 已禁用注意直接修改该状态控件不负责重绘 ### uiCtrlPlusObject.state.dragging # 是否按下鼠标且正在拖动 ### uiCtrlPlusObject.state.focus # 是否已得到焦点注意直接修改该状态控件不负责重绘 ### uiCtrlPlusObject.state.hover # 鼠标是否在控件上方注意直接修改该状态控件不负责重绘 ## win.ui.ctrl.plus 成员列表 # 高级图像控件 ### win.ui.ctrl.plus.progressColors # 进度条与滑尺的预设配色方案，这是一个 ARGB 格式颜色值数组。