RadioButtons 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

表示一个控件，该控件显示一组相关选项，可以从中选择一个。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadioButtons : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class RadioButtons : Control

Public Class RadioButtons
Inherits Control

继承

Control

RadioButtons

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 单选按钮。

打开 WinUI 2 库应用，查看操作中的 RadioButton。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

有关详细信息、设计指南和代码示例，请参阅 单选按钮。

使用单选按钮（也称为选项按钮）允许用户从两个或更多相互排斥但相关的选项的集合中选择一个选项。 单选按钮始终成组使用，每个选项都表示为组中的一个单选按钮。

控件 RadioButtons 简化了布局，处理键盘导航和辅助功能，并支持绑定到数据源。 使用 RadioButtons 时，可以将选项组视为单个实体，而不是跟踪单个 RadioButton 控件。

RadioButtons 控件使用类似于 ItemsControl 的内容模型。 这意味着你可以：

• 通过直接向 Items 集合添加项或将数据绑定到其 ItemsSource 属性来填充该控件。
• 使用 SelectedIndex 或 SelectedItem 属性来获取和设置所选的选项。
• 处理 SelectionChanged 事件，以便在选择某个选项时执行操作。

控件样式和模板

可以修改默认 的 Style 和 ControlTemplate ，为控件提供唯一的外观。 有关修改控件样式和模板的信息，请参阅 XAML 样式。 文件中包含 generic.xaml 定义控件外观的默认样式、模板和资源。 出于设计目的， generic.xaml 随 WinUI (Microsoft.UI.Xaml) NuGet 包一起安装。 默认情况下，此位置是 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 不同版本的 WinUI 的样式和资源可能具有不同的值。

XAML 还包括可用于在不修改控件模板的情况下修改不同视觉状态下控件颜色的资源。 修改这些资源优先于设置 背景 和 前台等属性。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

构造函数

RadioButtons()

初始化 RadioButtons 类的新实例。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

属性

Header	获取或设置组标头的内容。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
HeaderProperty	标识 Header 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplate	获取或设置用于显示控件标头内容的数据模板。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplateProperty	标识 HeaderTemplate 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
Items	获取用于生成控件内容的集合。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsProperty	标识 Items 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsSource	获取或设置用于生成控件内容的对象源。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsSourceProperty	标识 ItemsSource 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplate	获取或设置用于显示每个项的 DataTemplate 。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateProperty	标识 ItemTemplate 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
MaxColumns	获取或设置单选按钮在中排列的最大列数。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
MaxColumnsProperty	标识 MaxColumns 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedIndex	获取或设置所选单选按钮的索引。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedIndexProperty	标识 SelectedIndex 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedItem	获取或设置所选单选按钮。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedItemProperty	标识 SelectedItem 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

方法

ContainerFromIndex(Int32)

返回项集合中指定索引处的项的容器。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

事件

SelectionChanged

在当前所选项更改时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• 单选按钮