# win.ui.ctrl.syslink 库模块帮助文档

用法步骤

请参考： - [使用自定义控件类指南](https://www.aardio.com/zh-cn/docs/library-guide/std/win/ui/ctrl/custom.html#cls) - [syslink 控件使用范例](https://www.aardio.com/zh-cn/docs/examples/Windows/Controls/syslink.html) atlax 控件用法步骤： 1. 拖一个 custom 控件放到界面上,控件类名改为"atlax" 2. 然后在 atlax 控件的文本属性中指定要创建的 COM 类名，例如 "InkEd.InkEdit"

[范例](https://www.aardio.com/zh-cn/docs/examples/Windows/Controls/syslink.html) ## win.ui.ctrl 成员列表 # ### win.ui.ctrl.syslink # 超链接控件类 ### win.ui.ctrl.syslink() # 超链接控件。 [返回对象:syslinkObject](#syslinkObject) ## syslinkObject 成员列表 # ### syslinkObject._parentForm # 返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，控件的 _parentForm 始终都不会改变 [返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform) ### syslinkObject.adjust # ```aardio syslinkObject.adjust = function( cx,cy,wParam ) { }; ``` ### syslinkObject.adjust() # 调整窗口 - 自定义事件函数 ### syslinkObject.bottom # 底部坐标 ### syslinkObject.capture # 是否捕获全局鼠标消息 ### syslinkObject.changeInterval(定时器ID,间隔时间,回调函数) # 重新设置间隔时间或回调函数 ### syslinkObject.className # 运行时类名 ### syslinkObject.clearInterval(定时器ID) # 删除定时器 ### syslinkObject.close() # 关闭控件窗口 ### syslinkObject.cls # 设计时类名 ### syslinkObject.disabled # 是否禁用 ### syslinkObject.getClientRect() # 控件客户区块位置(::RECT结构体) [返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject) ### syslinkObject.getFont() # 控件字体(::LOGFONT结构体) [返回对象:logfontObject](#logfontObject) ### syslinkObject.getItem() # [返回对象:syslinklitemObject](#syslinklitemObject) ### syslinkObject.getItem(索引) # 返回超链接设置,该值为 LITEM 结构体。参数指定获取第几个超链接的设置，默认值为 1。 ### syslinkObject.getParent() # 返回父窗口 [返回对象:syslinkObject](#syslinkObject) ### syslinkObject.getPos() # 返回相对坐标,宽,高 x,y,cx,cy=win.getPos(hwnd) ### syslinkObject.getRect() # 控件区块位置(::RECT结构体) ### syslinkObject.getRect(true) # 控件屏幕区块位置(::RECT结构体) ### syslinkObject.height # 高度 ### syslinkObject.hwnd # 控件句柄 ### syslinkObject.id # 控件 ID，注意这个不是指超链接的 ID。 ### syslinkObject.invalidate(/*可选使用::RECT()对象指定客户区*/) # 使窗口绘图区无效 ### syslinkObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) # 使窗口绘图区无效不刷新背景 ### syslinkObject.left # 左侧坐标 ### syslinkObject.link # 创建、设置或者获取控件的第一个超链接地址。这个参数应当指定一个网址，可使用任意协议。 ### syslinkObject.modifyStyle(remove,add,swpFlags) # 修改窗口样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### syslinkObject.modifyStyleEx(remove,add,swpFlags) # 修改窗口扩展样式,所有参数都是可选参数, @remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量 @add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量 @swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos 细节请参考 win.modifyStyle 函数源码 ### syslinkObject.redraw() # 刷新 ### syslinkObject.right # 右侧坐标 ### syslinkObject.setFocus() # 设置焦点 ### syslinkObject.setFont(指定字体) # 指定LOGFONT字体对象,或逻辑字体句柄 ### syslinkObject.setFont(混入字体属性) # ```aardio syslinkObject.setFont(point=10;name="宋体"); ``` ### syslinkObject.setInterval(回调函数,延时毫秒数,...) # ```aardio syslinkObject.setInterval(回调函数,延时毫秒数,...setInterval( function(){ /*参数@1指定执行函数,参数@2指定执行间隔，可选指定一个或多个回调参数，不指定回调参数则默认为: hwnd,message,timerId,tick, 如果在定时器中执行了win.delay等继续消息循环的代码，在定时器退出前不会再触发同一定时器（重入）。定时器回调函数返回数值可修改时间间隔, 返回false取消该定时器*/ },1000 ) ``` ### syslinkObject.setItem(item) # 修改超链接设置,参数为 getItem 函数返回的 LITEM 结构体 ### syslinkObject.setParent(控件对象) # 改变父窗口 ### syslinkObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) # 调整窗口位置或排序,所有参数可选同时指定x,y坐标则移动位置同时指定宽高则改变大小指定插入位置(句柄或_HWND前缀常量)则调整Z序 ### syslinkObject.setRect(rc) # 设置控件区块位置(::RECT结构体) ### syslinkObject.setRect(rc,true) # 设置控件屏幕区块位置(::RECT结构体) ### syslinkObject.setRedraw(false) # 禁止重绘 ### syslinkObject.setRedraw(true) # 恢复重绘 ### syslinkObject.show(true) # 显示控件 ### syslinkObject.text # 控件文本。此控件的文本属性支持 HTML 的超链接语法，也就是 a 标签。超链接可选使用 href 属性设置超链接，可选使用 id 属性指定链接 ID。一个控件可以指定多个普通文本或者超链接，使用超链接索引区分。不支持其他 HTML 语法，例如换行应当直接换行而不是使用 `
`换行。可使用 link 属性获取或设置第一个超链接地址。 ### syslinkObject.theme # 外观主题,例如 winform.button.theme = "Explorer" winform.button.theme = false ### syslinkObject.top # 顶部坐标 ### syslinkObject.translateAccelerator # ```aardio syslinkObject.translateAccelerator = function(msg){ /*返回是否快捷键*/ } ``` ### syslinkObject.update() # 重绘invalidate函数指定的区块 ### syslinkObject.visible # 当前控件窗口是否显示。仅检查当前窗口的可见性样式（窗口是否具有 _WS_VISIBLE 样式）。不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。 ### syslinkObject.width # 宽度 ## syslinkObject 事件列表 # ### syslinkObject.onHyperlinkClick # ```aardio syslinkObject.onHyperlinkClick = function(nmSysLink,url,id,index){ raw.execute(url);/*点击超链接回调此事件，可使用此代码打开超链接。如果不指定回调函数，控件会默认调用 raw.execute 打开链接。 nmSysLink 为通知消息使用的 LITEM 结构体，一般忽略即可。 url 为触发的超链接地址，也就是 href 属性。 id 为触发的链接 ID，也就是 id 属性。 index 为索引，一个控件可以有多个超链接，第一个超链接索引为 1。*/ } ``` ## syslinklitemObject 成员列表 # ### syslinklitemObject.iLink # 索引。一个控件可以有多个超链接，第一个超链接索引为 1。 ### syslinklitemObject.id # 超链接的 ID 属性。 ### syslinklitemObject.mask # 有效字段掩码。默认已设为 _LIF_ITEMINDEX | _LIF_STATE | _LIF_ITEMID | _LIF_URL ### syslinklitemObject.state # 状态，一般用不上。可选值为 _LIS_ENABLED, _LIS_FOCUSED, _LIS_VISITED 等 ### syslinklitemObject.stateMask # 有效状态掩码 ### syslinklitemObject.url # 超链接的 URL 属性。