AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpencvPoint
- OpencvRect
- OpencvSize

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# 消息浮动框 (Toast)#

toast 模块用于 消息浮动框 的 [ 显示 / 消除 / 定制 ] 等.

部分操作系统的 toast 消息可能无法按队列依次显示, 新的 toast 消息直接覆盖之前的 toast 消息.

可能出现上述异常的操作系统:

- API 级别 28 (安卓 9) [P]
- 鸿蒙 (HarmonyOS) 2

部分机型需授予 "后台弹出页面" 权限才能正常显示 toast 消息.

可能依赖上述权限的设备及操作系统:

- 小米 (XiaoMi / Redmi / BlackShark) - MIUI
- 维沃 (VIVO / IQOO) - Funtouch OS / OriginOS
- 欧珀 (OPPO / Realme) - ColorOS

部分机型的 toast 消息正常显示依赖通知权限, 当未授予通知权限或通知被 `阻止 (block)` 时, toast 可能无法正常显示, 参阅 notice.isEnabled 小节.

toast

## [@] toast#

toast 可作为全局对象使用:

    typeof toast; // "function"
    typeof toast.dismissAll; // "function"

### toast(text)#

`Global` `Overload 1/4` `Async`

- text { string } - 消息内容
- returns { void }

显示一个消息浮动框.

消息框的显示默认是依次进行的:

    /* 显示消息框 2 秒钟. */
    toast("hello");
    /* 显示消息框 2 秒钟, 且在前一个消息框消失后才显示. */
    toast("world");
    /* 显示消息框 2 秒钟, 且在前一个消息框消失后才显示. */
    toast("hello world");

### toast(text, isLong)#

`Global` `Overload 2/4` `Async`

- text { string } - 消息内容
- isLong = false { `'long'` | `'l'` | `'short'` | `'s'` | boolean } - 是否以较长时间显示
- returns { void }

控制单个消息框显示时长:

    toast("hello", 'long'); /* 显示消息框 3.5 秒钟. */
    toast("hello", true); /* 同上. */

> 注: 仅有 [ 长 / 短 ] 两种时长, 此时长由安卓系统决定.
> 通常, 短时为 2 秒, 长时为 3.5 秒.

### toast(text, isLong, isForcible)#

`Global` `Overload 3/4` `Async`

- text { string } - 消息内容
- isLong = false { `'long'` | `'l'` | `'short'` | `'s'` | boolean } - 是否以较长时间显示
- isForcible = false { `'forcible'` | `'f'` | boolean } - 是否强制覆盖显示
- returns { void }

使用 "强制覆盖显示" 参数可立即显示消息框:

    toast("hello");
    /* 显示消息框 2 秒钟, 且立即显示, 前一个消息框 "hello" 被 "覆盖". */
    toast("world", "short", "forcible");

> 注: 强制覆盖仅对当前脚本有效, 对其他脚本及应用程序无效.

### toast(text, isForcible)#

`Global` `Overload 4/4` `Async`

- text { string } - 消息内容
- isForcible { `'forcible'` | `'f'` } - 强制覆盖显示 (字符标识)
- returns { void }

此方法相当于忽略 isLong 参数:

    toast("hello");
    /* 显示消息框 2 秒钟, 且立即显示, 前一个消息框 "hello" 被 "覆盖". */
    toast("world", "forcible");

> 注: 此方法的 isForcible 参数只能为具有明确意义的字符标识, 不能为 boolean 类型或其他类型, 否则 isForcible 将被视为 isLong.

## [m] dismissAll#

### dismissAll()#

`Global` - returns { void }

强制消除所有由 AutoJs6 产生的消息框, 包括正在显示的及等待显示的.

使用方式:

    toast.dismissAll(); /* 立即消除所有消息框. */

示例:

    toast("hello");
    toast("world");
    toast("of");
    toast("JavaScript");

    sleep(1e3);

    /* "hello" 显示 1 秒后消失, "world" 及其他消息框均不再显示. */
    /* 若无 sleep 语句, 由于 toast 是异步的, 上述消息框均不会显示. */
    toast.dismissAll();

    /* dismissAll 仅对已在队列中的消息框有效, 因此下述消息框正常显示. */
    toast("forcibly dismissed");

> 注: 强制取消显示仅对当前脚本有效, 对其他脚本及应用程序无效.