RadioDelegate QML 类型

带有可切换开或关的收音机指示器的专用项目代理。 更多...

• 所有成员列表，包括继承的成员

详细描述

RadioDelegate 提供了一个可切换为选中（选中）或关闭（未选中）的项目代理。Radio 代理通常用于从一个选项集中选择一个选项。

RadioDelegate 从 ItemDelegate 继承其 API，后者又从 AbstractButton 继承。例如，您可以设置 text，并使用 AbstractButton API 响应 点击。使用 checked 属性设置 Radio 代理的状态。

Radio 代理默认启用 auto-exclusive。在任何时候，同一父项目下的 Radio 代理中只能有一个被选中；选中另一个代理会自动取消选中之前选中的代理。对于没有共同父项的 Radio 代理，可以使用 ButtonGroup 来管理唯一性。

RadioButton 与 RadioDelegate 类似，但通常不用于视图中，而是在只有少量选项且经常需要每个按钮具有唯一标识符的情况下使用。

ButtonGroup {
    id: buttonGroup
}

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: RadioDelegate {
        text: modelData
        checked: index == 0
        ButtonGroup.group: buttonGroup
    }
}

另请参阅 自定义 RadioDelegate、代理控件 和 RadioButton。