aardio 文档

win.ui.atom 库模块帮助文档

win.ui.atom 成员列表 #

导入此库以后 win.form 对象自动增加 atom 方法(调用参数 @1 为包含唯一 ID 的字符串)。

win.ui.atom.find("字符串参数") #

在桌面顶层窗口查找原子窗体,
返回原子值,以及原子窗体句柄.

win.ui 成员列表 #

win.ui.atom(winform,uid) #

创建原子窗体,可避免重复运行。
参数 @1 指定 win.form 对象,参数@uid 指定唯一 ID。
可使用「aardio 工具 » 编码 » GUID 生成与转换」 生成唯一 ID 。
如果不指定 @uid 则会生成一个默认 ID(根据启动路径、窗口特证计算,并不能保证唯一性)。

成功返回原子 ID 值(数值),失败返回 null,已存在的相同原子窗体句柄。
如果已存在相同原子窗体则会自动前置该窗体并调用 win.quitMessage 函数以退出消息循环。
调用者应当检查原子值,如果返回的原子值为 null 应当退出程序。
原子由 process.atom add 函数创建,请参考相关库: process.atom 。

Markdown 格式