# win.ui.ctrl.atlax 库模块帮助文档
用法步骤
请参考[使用自定义控件类](https://www.aardio.com/zh-cn/docs/library-guide/std/win/ui/ctrl/custom.html#cls)
atlax 控件用法步骤：
1. 拖一个 custom 控件放到界面上,控件类名改为"atlax"
2. 然后在 atlax 控件的文本属性中指定要创建的 COM 类名，例如 "InkEd.InkEdit"
## win.ui.ctrl 成员列表 #
### win.ui.ctrl.atlax #
静态文本控件支持库
### win.ui.ctrl.atlax() #
静态文本控件
[返回对象:atlAxWinObject](#atlAxWinObject)
## atlAxWinObject 成员列表 #
### atlAxWinObject._defWindowProc(hwnd,message,wParam,lParam) #
用于在 wndproc 回调中提前调用默认消息回调函数,
所有窗口和控件定义了 wndproc 回调以后会自动创建这个函数,
调用此函数以后,wndproc 必须指定非 null 返回值,
以避免再次重复调用默认回调函数
### atlAxWinObject._embedObject #
嵌入 COM 控件的容器对象
[返回对象:embedObject](https://www.aardio.com/zh-cn/docs/library-reference/com/_.html#embedObject)
### atlAxWinObject._parentForm #
返回创建控件的容器窗口（win.form对象），所有窗口控件都拥有此只读属性。
对于使用窗体设计器创建的窗口，也就是返回设计时窗体容器。
即使子窗口移除子窗口样式、更改父子关系，或以 orphanWindow显示，
控件的 _parentForm 始终都不会改变
[返回对象:winform](https://www.aardio.com/zh-cn/docs/library-reference/win/ui/_.html#winform)
### atlAxWinObject.addCtrl #
```aardio
atlAxWinObject.addCtrl(
button={ cls="button";text="button";left=33;top=32;right=126;bottom=81;autoResize=false }
)
```
### atlAxWinObject.adjust #
```aardio
atlAxWinObject.adjust = function( cx,cy,wParam ) {
};
```
### atlAxWinObject.adjust() #
调整窗口 - 自定义事件函数
### atlAxWinObject.bgcolor #
获取或修改景颜色数值
### atlAxWinObject.bottom #
底部坐标
### atlAxWinObject.capture #
是否捕获全局鼠标消息
### atlAxWinObject.changeInterval(定时器ID,间隔时间,回调函数) #
重新设置间隔时间或回调函数
### atlAxWinObject.className #
运行时类名
### atlAxWinObject.clearInterval(定时器ID) #
删除定时器
### atlAxWinObject.close() #
关闭控件窗口
### atlAxWinObject.cls #
设计时类名
### atlAxWinObject.color #
获取或修改字体颜色数值
### atlAxWinObject.disabled #
是否禁用
### atlAxWinObject.getClientRect() #
控件客户区块位置(::RECT结构体)
[返回对象:rectObject](https://www.aardio.com/zh-cn/docs/library-reference/global/_.html#rectObject)
### atlAxWinObject.getControl() #
返回com控件对象
aardio默认会尝试将atlax创建控件自身注册为默认事件接口
### atlAxWinObject.getControlClsId() #
返回COM对象类名
### atlAxWinObject.getControlTypeName() #
返回COM接口名
### atlAxWinObject.getFont() #
控件字体(::LOGFONT结构体)
[返回对象:logfontObject](#logfontObject)
### atlAxWinObject.getParent() #
返回父窗口
[返回对象:atlAxWinObject](#atlAxWinObject)
### atlAxWinObject.getPos() #
返回相对坐标,宽,高
x,y,cx,cy=win.getPos(hwnd)
### atlAxWinObject.getRect() #
控件区块位置(::RECT结构体)
### atlAxWinObject.getRect(true) #
控件屏幕区块位置(::RECT结构体)
### atlAxWinObject.height #
高度
### atlAxWinObject.hwnd #
控件句柄
### atlAxWinObject.id #
控件ID
### atlAxWinObject.invalidate(/*可选使用::RECT()对象指定客户区*/) #
使窗口绘图区无效
### atlAxWinObject.invalidate(/*可选使用::RECT()对象指定客户区*/,0) #
使窗口绘图区无效
不刷新背景
### atlAxWinObject.isForm #
标准库 win.ui 创建的所有窗体与控件对象都拥有此属性。
win.form 创建的窗体对象返回 true,其他控件对象返回 false 。
### atlAxWinObject.left #
左侧坐标
### atlAxWinObject.messageOnly() #
将窗口转换为message-only window
该窗口不可见,仅用于消息分发
### atlAxWinObject.modifyStyle(remove,add,swpFlags) #
修改窗口样式,所有参数都是可选参数,
@remove 用数值指定要移除的样式,可使用 _WS_ 前缀的常量
@add 用数值指定要添加的样式,可使用 _WS_ 前缀的常量
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos
细节请参考 win.modifyStyle 函数源码
### atlAxWinObject.modifyStyleEx(remove,add,swpFlags) #
修改窗口扩展样式,所有参数都是可选参数,
@remove 用数值指定要移除的样式,可使用 _WS_EX_ 前缀的常量
@add 用数值指定要添加的样式,可使用 _WS_EX_ 前缀的常量
@swpFlags 可选用数值指定调整窗口选项,可使用 _SWP_ 前缀的常量
如果指定了 @swpFlag ,则使用该参数调用::SetWindowPos
细节请参考 win.modifyStyle 函数源码
### atlAxWinObject.msgbox("字符串参数") #
弹出对话框,可选用参数@2指定标题
### atlAxWinObject.msgboxErr("字符串参数") #
弹出错误对话框,可选用参数@2指定标题
### atlAxWinObject.msgboxTest("字符串参数") #
弹出询问对话框,可选用参数@2指定标题
### atlAxWinObject.orphanWindow(transparent,hwndBuddy,borderless) #
创建悬浮窗口。
悬浮窗口是模仿子窗口外观效果的独立窗口，父窗口可自动调整子窗口到设定位置。
可选参数 @transparent 为 true 则转换为分层透明窗口。
可选利用 @hwndBuddy 参数指定外部进程窗口句柄的并附加在内部控件上以实现相同的效果。
伙伴窗口总是会保持在悬浮窗口前面，并保持相同的大小、位置。
可重复调用此函数更换伙伴窗口，旧的伙伴窗口必须自行关闭。
可选指定 @borderless 参数 为 true 以移除 @hwndBuddy 的窗口边框。
### atlAxWinObject.redraw() #
刷新
### atlAxWinObject.redrawTransparent() #
刷新
透明背景时请使用此函数替代redraw()
### atlAxWinObject.right #
右侧坐标
### atlAxWinObject.setFocus() #
设置焦点
### atlAxWinObject.setFont(指定字体) #
指定LOGFONT字体对象,或逻辑字体句柄
### atlAxWinObject.setFont(混入字体属性) #
```aardio
atlAxWinObject.setFont(point=10;name="宋体");
```
### atlAxWinObject.setInterval(回调函数,延时毫秒数,...) #
```aardio
atlAxWinObject.setInterval(回调函数,延时毫秒数,...setInterval(
function(){
/*参数@1指定执行函数,参数@2指定执行间隔，
可选指定一个或多个回调参数，不指定回调参数则默认为:
hwnd,message,timerId,tick,
如果在定时器中执行了win.delay等继续消息循环的代码，
在定时器退出前不会再触发同一定时器（重入）。
定时器回调函数返回数值可修改时间间隔,
返回false取消该定时器*/
},1000
)
```
### atlAxWinObject.setParent(控件对象) #
改变父窗口
### atlAxWinObject.setPos(x坐标,y坐标,宽,高,插入位置,参数) #
调整窗口位置或排序,所有参数可选
同时指定x,y坐标则移动位置
同时指定宽高则改变大小
指定插入位置(句柄或_HWND前缀常量)则调整Z序
### atlAxWinObject.setRect(rc) #
设置控件区块位置(::RECT结构体)
### atlAxWinObject.setRect(rc,true) #
设置控件屏幕区块位置(::RECT结构体)
### atlAxWinObject.setRedraw(false) #
禁止重绘
### atlAxWinObject.setRedraw(true) #
恢复重绘
### atlAxWinObject.show(true) #
显示控件
### atlAxWinObject.text #
控件文本。
在创建控件的构造参数中使用 text 段指定要创建的 COM 对象类名。
### atlAxWinObject.theme #
外观主题,例如
winform.button.theme = "Explorer"
winform.button.theme = false
### atlAxWinObject.top #
顶部坐标
### atlAxWinObject.translateAccelerator #
```aardio
atlAxWinObject.translateAccelerator = function(msg){
/*返回是否快捷键*/
}
```
### atlAxWinObject.update() #
重绘invalidate函数指定的区块
### atlAxWinObject.visible #
当前控件窗口是否显示。
仅检查当前窗口的可见性样式（窗口 是否具有 _WS_VISIBLE 样式）。
不考虑父窗口是否可见，不考虑是否被其他窗口遮挡。
如果需要同时判断父窗口的可见性，应改用 win.isVisible 函数。
### atlAxWinObject.width #
宽度