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

## win.ui.atom 成员列表 <a id="win.ui.atom" href="#win.ui.atom">&#x23;</a>

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

### win.ui.atom.find("字符串参数") <a id="win.ui.atom.find" href="#win.ui.atom.find">&#x23;</a>
在桌面顶层窗口查找原子窗体,  
返回原子值,以及原子窗体句柄.

## win.ui 成员列表 <a id="win.ui" href="#win.ui">&#x23;</a>

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

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