对话框构建器

什么是对话框构建器？

对话框构建器是一项实用的功能，让您可以在宏中创建交互式对话框。这些对话框通常用于在宏开始主流程执行之前收集用户的输入。您可以把它看作是一种根据用户选择来自定义宏行为的方式。

例如，您可以创建一个对话框询问：“您想运行哪个选项？”如果用户选择了选项 5，宏就会执行与该选择相关的一组特定操作。

对话框组件

对话框由各种 UI 组件构建而成。每个对话框可以包含以下元素：

1. CheckBox（复选框）：用于“是/否”或“真/假”选择
2. EditText（文本输入）：用于自由格式的文本输入
3. RadioGroup（单选组）：多个 RadioButton（单选按钮）的容器
4. Column（列）：垂直布局容器
5. Row（行）：水平布局容器
6. RadioButton（单选按钮）：用于在 RadioGroup 中进行单选
7. TextView（文本视图）：用于显示文本信息

默认值

对话框输入组件现在可以在对话框显示之前定义初始值：

• EditText(id, hint, defaultValue) 用于设置起始文本
• CheckBox(id, text, defaultChecked) 用于设置起始勾选状态
• RadioGroup(id, defaultButtonId) 用于默认选中某个单选按钮

当提供了默认值时，对话框打开时会优先使用该默认值。

构建您的对话框

您可以组合这些组件，创建一个适合您宏需求的自定义对话框。在这些组件中，有三种输入类型可以从中获取值：

• CheckBox
• EditText
• RadioGroup

要从这些输入组件中获取值，您可以在宏逻辑中使用 Dialog:getValueById() 函数。通过指定组件的唯一 ID，您可以获取用户的输入，并用它来指导宏的操作。

说明：对话框中的每个组件都必须拥有唯一的 ID。这样可以确保宏能够正确识别并从您所指定的组件中获取值。重复的 ID 可能会导致混淆，并在宏执行时引发错误。