其他

## ui.layout(xml) * `xml` {XML} | {string} 布局XML或者XML字符串 将布局XML渲染为视图(View)对象, 并设置为当前视图。 ## ui.layoutFile(xmlFile) * `xml` {string} 布局XML文件的路径 此函数和`ui.layout`相似,只不过允许传入一个xml文件路径来渲染布局。 ## ui.inflate(xml[, parent = null, attachToParent = false]) * `xml` {string} | {XML} 布局XML或者XML字符串 * `parent` {View} 父视图 * `attachToParent` {boolean} 是否渲染的View加到父视图中,默认为false * 返回 {View} 将布局XML渲染为视图(View)对象。如果该View将作为某个View的子View,我们建议传入`parent`参数,这样在渲染时依赖于父视图的一些布局属性能够正确应用。 此函数用于动态创建、显示View。 ```javascript "ui"; $ui.layout( ); // 动态创建3个文本控件,并加到container容器中 // 这里仅为实例,实际上并不推荐这种做法,如果要展示列表, // 使用list组件;动态创建十几个、几十个View会让界面卡顿 for (let i = 0; i < 3; i++) { let textView = $ui.inflate( , $ui.container); textView.attr("text", "文本控件" + i); $ui.container.addView(textView); } ``` ## ui.registerWidget(name, widget) * `name` {string} 组件名称 * `widget` {Function} 组件 注册一个自定义组件。参考示例->界面控件->自定义控件。 ## ui.isUiThread() * 返回 {boolean} 返回当前线程是否是UI线程。 ```javascript "ui"; log($ui.isUiThread()); // => true $threads.start(function () { log($ui.isUiThread()); // => false }); ``` ## ui.findView(id) * `id` {string} View的ID * 返回 {View} 在当前视图中根据ID查找相应的视图对象并返回。如果当前未设置视图或找不到此ID的视图时返回`null`。 一般我们都是通过`ui.xxx`来获取id为xxx的控件,如果xxx是一个ui已经有的属性,就可以通过`$ui.findView()`来获取这个控件。 ## ui.finish() 结束当前活动并销毁界面。 ## ui.setContentView(view) * `view` {View} 将视图对象设置为当前视图。 ## ui.post(callback[, delay = 0]) * `callback` {Function} 回调函数 * `delay` {number} 延迟,单位毫秒 将`callback`加到UI线程的消息循环中,并延迟delay毫秒后执行(不能准确保证一定在delay毫秒后执行)。 此函数可以用于UI线程中延时执行动作(sleep不能在UI线程中使用),也可以用于子线程中更新UI。 ```javascript "ui"; ui.layout( ); ui.result.attr("text", "计算中"); // 在子线程中计算1+ ... + 10000000 threads.start({ let sum = 0; for (let i = 0; i < 1000000; i++) { sum += i; } // 由于不能在子线程操作UI,所以要抛到UI线程执行 ui.post(() => { ui.result.attr("text", String(sum)); }); }); ``` ## ui.run(callback) * `callback` {Function} 回调函数 * 返回 callback的执行结果 将`callback`在UI线程中执行。如果当前已经在UI线程中,则直接执行`callback`;否则将`callback`抛到UI线程中执行(加到UI线程的消息循环的末尾),**并等待callback执行结束(阻塞当前线程)**。 ## ui.statusBarColor(color) * color {string} | {number} 颜色 设置当前界面的状态栏颜色。 ```javascript "ui"; ui.statusBarColor("#000000"); ``` ## ui.useAndroidResources() 启用使用Android的布局(layout)、绘图(drawable)、动画(anim)、样式(style)等资源的特性。启用该特性后,在project.json中进行以下配置,就可以像写Android原生一样写界面: ```json { // ... androidResources: { "resDir": "res", // 资源文件夹 "manifest": "AndroidManifest.xml" // AndroidManifest文件路径 } } ``` res文件夹通常为以下结构: ``` - res - layout // 布局资源 - drawable // 图片、形状等资源 - menu // 菜单资源 - values // 样式、字符串等资源 // ... ``` 可参考示例->复杂界面->Android原生界面。 ## $ui.imageCache.clearDiskCache() **[[Pro 8.8.16新增](https://pro.autojs.org/)]** 清除UI的图片文件缓存,通常是清除使用url下载的图片缓存。(比如img控件的url链接加载的图片) 此函数也可用于清除自定义启动图中的图片控件的文件缓存。 此函数和找图找色无关,并不会清除图色相关的图片内存、缓存。 此函数需要若在UI线程执行,会自动切换到IO线程异步执行,因此在UI线程执行时,函数返回不代表文件缓存已全部清理完毕。 ## $ui.imageCache.clearMemory() **[[Pro 8.8.16新增](https://pro.autojs.org/)]** 清除UI的图片内存缓存。 此函数和找图找色无关,并不会清除图色相关的图片内存、缓存。 # 尺寸的单位: Dimension # Drawables # 颜色 **(完善中...)**