- WPF 教程
- WPF - 首页
- WPF - 概述
- WPF - 环境设置
- WPF - Hello World
- WPF - XAML 概述
- WPF - 元素树
- WPF - 依赖属性
- WPF - 路由事件
- WPF - 控件
- WPF - 布局
- WPF - 布局嵌套
- WPF - 输入
- WPF - 命令行
- WPF - 数据绑定
- WPF - 资源
- WPF - 模板
- WPF - 样式
- WPF - 触发器
- WPF - 调试
- WPF - 自定义控件
- WPF - 异常处理
- WPF - 本地化
- WPF - 交互
- WPF - 2D 图形
- WPF - 3D 图形
- WPF - 多媒体
- WPF 有用资源
- WPF - 快速指南
- WPF - 有用资源
- WPF - 讨论
WPF - 单选按钮
单选按钮是一个控件,允许用户从一组选项中选择单个选项。用户只能从相关选项列表中选择一个选项,这些选项是互斥的。它只有两个选项:
- 已选中
- 已清除
RadioButton 类的层次继承如下:
RadioButton 常用属性
| 序号 | 属性及说明 |
|---|---|
| 1 | Background 获取或设置一个画刷,该画刷提供控件的背景。(继承自 Control) |
| 2 | BorderBrush 获取或设置一个画刷,该画刷描述控件的边框填充。(继承自 Control) |
| 3 | BorderThickness 获取或设置控件的边框粗细。(继承自 Control) |
| 4 | Content 获取或设置 ContentControl 的内容。(继承自 ContentControl) |
| 5 | ClickMode 获取或设置一个值,该值指示 Click 事件何时发生,以设备行为表示。(继承自 ButtonBase) |
| 6 | ContentTemplate 获取或设置用于显示 ContentControl 内容的数据模板。(继承自 ContentControl) |
| 7 | FontFamily 获取或设置用于在控件中显示文本的字体。(继承自 Control) |
| 8 | FontSize 获取或设置此控件中文本的大小。(继承自 Control) |
| 9 | FontStyle 获取或设置呈现文本的样式。(继承自 Control) |
| 10 | FontWeight 获取或设置指定字体的粗细。(继承自 Control) |
| 11 | Foreground 获取或设置一个画刷,该画刷描述前景色。(继承自 Control) |
| 12 | Height 获取或设置 FrameworkElement 的建议高度。(继承自 FrameworkElement) |
| 13 | HorizontalAlignment 获取或设置当 FrameworkElement 在布局父级(如面板或项目控件)中组合时应用的水平对齐特性。(继承自 FrameworkElement) |
| 14 | IsChecked 获取或设置 ToggleButton 是否被选中。(继承自 ToggleButton) |
| 15 | IsEnabled 获取或设置一个值,该值指示用户是否可以与控件交互。(继承自 Control) |
| 16 | IsPressed 获取一个值,该值指示 ButtonBase 当前是否处于按下状态。(继承自 ButtonBase) |
| 17 | IsThreeState 获取或设置一个值,该值指示控件是否支持三种状态。(继承自 ToggleButton) |
| 18 | Margin 获取或设置 FrameworkElement 的外边距。(继承自 FrameworkElement) |
| 19 | Name 获取或设置对象的标识名称。当 XAML 处理器从 XAML 标记创建对象树时,运行时代码可以通过此名称引用 XAML 声明的对象。(继承自 FrameworkElement) |
| 20 | Opacity 获取或设置对象的透明度。(继承自 UIElement) |
| 21 | Resources 获取本地定义的资源字典。在 XAML 中,您可以将资源项作为 frameworkElement.Resources 属性元素的子对象元素建立,通过 XAML 隐式集合语法。(继承自 FrameworkElement) |
| 22 | Style 获取或设置在此对象布局和呈现期间应用的实例样式。(继承自 FrameworkElement) |
| 23 | Template 获取或设置控件模板。控件模板定义了控件在 UI 中的视觉外观,并在 XAML 标记中定义。(继承自 Control) |
| 24 | VerticalAlignment 获取或设置当 FrameworkElement 在父对象(如面板或项目控件)中组合时应用的垂直对齐特性。(继承自 FrameworkElement) |
| 25 | Visibility 获取或设置 UIElement 的可见性。不可见的 UIElement 不会呈现,也不会将其所需的大小传达给布局。(继承自 UIElement) |
| 26 | Width 获取或设置 FrameworkElement 的宽度。(继承自 FrameworkElement) |
RadioButton 常用方法
| 序号 | 方法及说明 |
|---|---|
| 1 | ClearValue 清除依赖属性的局部值。(继承自 DependencyObject) |
| 2 | FindName 检索具有指定标识名称的对象。(继承自 FrameworkElement) |
| 3 | OnApplyTemplate 每当应用程序代码或内部进程(例如重建布局传递)调用 ApplyTemplate 时都会调用。简单来说,这意味着该方法在 UI 元素在应用程序中显示之前被调用。重写此方法以影响类的默认后模板逻辑。(继承自 FrameworkElement) |
| 4 | OnContentChanged 当 Content 属性的值更改时调用。(继承自 ContentControl) |
| 5 | OnDragEnter 在 DragEnter 事件发生之前调用。(继承自 Control) |
| 6 | OnDragLeave 在 DragLeave 事件发生之前调用。(继承自 Control) |
| 7 | OnDragOver 在 DragOver 事件发生之前调用。(继承自 Control) |
| 8 | OnDrop 在 Drop 事件发生之前调用。(继承自 Control) |
| 9 | OnGotFocus 在 GotFocus 事件发生之前调用。(继承自 Control) |
| 10 | OnKeyDown 在 KeyDown 事件发生之前调用。(继承自 Control) |
| 11 | OnKeyUp 在 KeyUp 事件发生之前调用。(继承自 Control) |
| 12 | OnLostFocus 在 LostFocus 事件发生之前调用。(继承自 Control) |
| 13 | OnToggle 当 ToggleButton 接收到切换刺激时调用。(继承自 ToggleButton) |
| 14 | SetBinding 使用提供的绑定对象将绑定附加到 FrameworkElement。(继承自 FrameworkElement) |
RadioButton 常用事件
| 序号 | 事件及说明 |
|---|---|
| 1 | Checked 当 ToggleButton 被选中时触发。(继承自 ToggleButton) |
| 2 | Click 当按钮控件被点击时发生。(继承自 ButtonBase) |
| 3 | DataContextChanged 当 FrameworkElement.DataContext 属性的值更改时发生。(继承自 FrameworkElement) |
| 4 | DragEnter 当输入系统报告以该元素作为目标的基础拖动事件时发生。(继承自 UIElement) |
| 5 | DragLeave 当输入系统报告以该元素作为源的基础拖动事件时发生。(继承自 UIElement) |
| 6 | DragOver 当输入系统报告以该元素作为潜在放置目标的基础拖动事件时发生。(继承自 UIElement) |
| 7 | DragStarting 当拖动操作启动时发生。(继承自 UIElement) |
| 8 | GotFocus 当 UIElement 获取焦点时发生。(继承自 UIElement) |
| 9 | Holding 当在此元素的命中测试区域上发生未经处理的 Hold 交互时发生。(继承自 UIElement) |
| 10 | Intermediate 当 ToggleButton 的状态切换到不确定状态时触发。(继承自 ToggleButton) |
| 11 | IsEnabledChanged 当 IsEnabled 属性更改时发生。(继承自 Control) |
| 12 | KeyDown 当 UIElement 具有焦点时按下键盘键时发生。(继承自 UIElement) |
| 13 | KeyUp 当 UIElement 具有焦点时释放键盘键时发生。(继承自 UIElement) |
| 14 | LostFocus 当 UIElement 失去焦点时发生。(继承自 UIElement) |
| 15 | SizeChanged 当 FrameworkElement 上的 ActualHeight 或 ActualWidth 属性的值更改时发生。(继承自 FrameworkElement) |
| 16 | Unchecked 当 ToggleButton 取消选中时发生。(继承自 ToggleButton) |
示例
让我们创建一个名为 **WPFDialog** 的新 WPF 项目。
从工具箱中拖动五个单选按钮和四个文本块,并将其排列如下面的 XAML 代码所示。
以下示例显示了如何使用 RadioButton。我们将显示两组 RadioButton。当用户选择一个选项时,程序将在 TextBlock 上显示消息。以下是 XAML 代码。
<Window x:Class = "WPFRadioButtonControl.MainWindow"
xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d = "http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:local = "clr-namespace:WPFRadioButtonControl"
mc:Ignorable = "d" Title = "MainWindow" Height = "350" Width = "604">
<Grid>
<TextBlock x:Name = "textBlock" HorizontalAlignment = "Left"
Margin = "23,68,0,0" TextWrapping = "Wrap" Text = "Gender:"
VerticalAlignment = "Top" Width = "83" />
<TextBlock x:Name = "textBlock1" HorizontalAlignment = "Left"
Margin = "23,134,0,0" TextWrapping = "Wrap" Text = "Marital Status:"
VerticalAlignment = "Top" Width = "83" />
<RadioButton x:Name = "rb1" Content = "Male" HorizontalAlignment = "Left"
Margin = "126,68,0,0" VerticalAlignment = "Top"
GroupName = "Gender" Width = "69" Checked = "HandleCheck" />
<RadioButton x:Name = "rb2" Content = "Female" HorizontalAlignment = "Left"
Margin = "201,68,0,0" VerticalAlignment = "Top"
GroupName = "Gender" Width = "81" Checked = "HandleCheck" />
<RadioButton x:Name = "rb3" Content = "Single" HorizontalAlignment = "Left"
Margin = "126,134,0,0" VerticalAlignment = "Top"
GroupName = "Status" Width = "69" Checked = "HandleCheck1" />
<RadioButton x:Name = "radioButton" Content = "Engaged" HorizontalAlignment = "Left"
Margin = "201,134,0,0" VerticalAlignment = "Top"
GroupName = "Status" Width = "89" Checked = "HandleCheck1" />
<RadioButton x:Name = "radioButton1" Content = "Married"
GroupName = "Status" HorizontalAlignment = "Left" Margin = "302,134,0,0"
VerticalAlignment = "Top" Width = "95" Checked = "HandleCheck1" />
<TextBlock x:Name = "textBlock2" HorizontalAlignment = "Left"
Margin = "386,68,0,0" TextWrapping = "Wrap"
VerticalAlignment = "Top" Width = "191" Height = "26" />
<TextBlock x:Name = "textBlock3" HorizontalAlignment = "Left"
Margin = "386,134,0,0" TextWrapping = "Wrap"
VerticalAlignment = "Top" Width = "146" Height = "31" />
</Grid>
</Window>
以下是不同事件的 **C# 实现**。
using System.Windows;
using System.Windows.Controls;
namespace WPFRadioButtonControl {
/// <summary>
/// Interaction logic for MainWindow.xaml
/// </summary>
public partial class MainWindow : Window {
public MainWindow() {
InitializeComponent();
}
private void HandleCheck1(object sender, RoutedEventArgs e) {
RadioButton rb = sender as RadioButton;
textBlock3.Text = "You are " + rb.Content;
}
private void HandleCheck(object sender, RoutedEventArgs e) {
RadioButton rb = sender as RadioButton;
textBlock2.Text = "You are " + rb.Content;
}
}
}
编译并执行上述代码后,将生成以下窗口。
建议您执行上述示例代码并尝试 RadioButton 的其他属性和事件。