← 返回单选框组件参考 · 全部使用指导

单选框使用指导

• 单选框使用指导
  • 快速上手：性别选择
  • 搭建与测试
  • 案例：读取选项并提交
  • 属性、方法与事件速查
  • 常见问题与验收
  • 完整 .aia 源码与操作指导
    • 单选框

一组互斥的单选按钮，一次只能选一项，适合问卷、表单、设置页（性别、单选题、支付方式等）。 App Inventor 原本只有复选框，单选只能拿几个复选框硬凑；单选框一个组件就搞定。

用法和下拉框一样：选项在设计器的「元素字串」里用逗号分隔填写（如 男,女,保密）， 或在代码块里设置「元素列表」；用户点选后触发选择完成时（选择项）（AfterSelecting）。 默认一项都不选（选中项索引为 0），提交前记得判断用户选了没有；在代码里设置选中项不会触发事件。

快速上手：性别选择

1. 拖一个单选框，「元素字串」填 男,女,保密，勾选「横向排列」；
2. 拖一个按钮（改名 按钮_提交）和一个标签（改名 标签_结果）；
3. 搭下面的代码块：

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when 单选框1.AfterSelecting(选择项) {
  标签_结果.Text = join("刚刚选了：", 选择项)
}

when 按钮_提交.Click {
  if 单选框1.SelectionIndex == 0 {
    标签_结果.Text = "请先选择性别"
  } else {
    标签_结果.Text = join("提交成功：", 单选框1.Selection)
  }
}

一个问卷有几道单选题，就放几个单选框，各管各的选项。

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

案例：读取选项并提交

放单选框、提交按钮和标签；先检查序号大于 0，再把选中的文字用于提交。

when Screen1.Initialize() {
  单选框1.Elements = list("标准配送", "加急配送")
  单选框1.SelectionIndex = 1
}
when 按钮_提交.Click() {
  if 单选框1.SelectionIndex > 0 {
    标签1.Text = join("已选择：", 单选框1.Selection)
  }
}

选项序号从 1 开始，0 表示没有选中。整体更换选项后重新检查当前选择；不要将选中文字当作固定编号。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

常见问题与验收

完整 .aia 源码与操作指导

下载 .aia 源码

导入 RadioGroupAllFeatures.aia。屏幕顶部是专业兴趣单选框，下方滚动区域提供全部操作。初始化为工科、理科、文科、医科四项，选中理科、纵向排列并启用。

覆盖检查 37/37。归档、正式编辑器首次导入／保存重开（0 错误）、变量下拉绑定、真实后台导入、安装包编译通过；本轮没有真机／伴侣实测。

单选框

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 专业兴趣选择案例：初始有工科、理科、文科、医科四项，选中理科，纵向排列并启用。 | 操作 | 预期结果 | |—|—| | 点击选项，按文字／索引选择 | 属性区显示选中项与从 1 开始的索引，事件区记录选择 | | 用元素字串／元素列表 | 切换四种学科与三个具体专业 | | 清空，再尝试按文字／索引选择 | 显示空状态提示，不访问无效索引，可重新载入 | | 切换横向／启用开关 | 改变排列方向；禁用时不能手点选择，可重新启用 | | 调字体／颜色，隐藏／恢复，设置尺寸 | 观察样式变化与实际属性值 | | 点恢复全部设置 | 恢复四项、理科、启用、纵向与初始样式 | 覆盖检查 37/37，包括全部选择和样式属性、公共尺寸与可见性、设计器配置，以及选择完成事件。两份案例也提供位置属性读取；普通排列仍按容器布局定位，此项不提供自由拖动。