XAML - 复选框

复选框是一个用户可以选择（选中）或取消选择（取消选中）的控件。它提供了一个用户可以选择的一系列选项，例如应用于应用程序的一系列设置。复选框类的层次继承如下：

属性

以下是复选框最常用的属性。

序号	属性和描述
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 获取或设置一个 Style 实例，在布局和渲染期间应用于此对象。（继承自 FrameworkElement）
23	Template 获取或设置控件模板。控件模板定义 UI 中控件的视觉外观，并在 XAML 标记中定义。（继承自 Control）
24	VerticalAlignment 获取或设置应用于 FrameworkElement 的垂直对齐特性，当它在父对象（如面板或项目控件）中组合时。（继承自 FrameworkElement）
25	Visibility 获取或设置 UIElement 的可见性。不可见的 UIElement 不会呈现，也不会将其所需大小传达给布局。（继承自 UIElement）
26	Width 获取或设置 FrameworkElement 的宽度。（继承自 FrameworkElement）

方法

以下是复选框常用的方法。

序号	方法和描述
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）

事件

以下是复选框常用的事件。

序号	事件和描述
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）

示例

以下示例包含两个复选框。第一个复选框有两个状态：选中或未选中。第二个复选框有三个状态：选中、未选中和不确定状态。两个复选框都根据 Checked、Unchecked 和 Intermediate 事件显示消息。

以下是创建了两个复选框并设置了一些属性和事件的 XAML 代码。

<Window x:Class = "XAMLCheckBox.MainWindow" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   Title = "MainWindow" Height = "350" Width = "604"> 
   
   <Grid> 
      <StackPanel Orientation = "Vertical" > 
         <CheckBox x:Name = "cb1"  
            Content = "2 state CheckBox" 
            Checked = "HandleCheck"  
            Unchecked = "HandleUnchecked" 
            Margin = "10" />
				
         <TextBlock x:Name = "text1" Margin = "10" />  
			
         <CheckBox x:Name = "cb2"  
            Content = "3 state CheckBox"  
            IsThreeState = "True"  
            Indeterminate = "HandleThirdState"  
            Checked = "HandleCheck"  
            Unchecked = "HandleUnchecked" 
            Margin = "10" />
				
         <TextBlock x:Name = "text2" Margin = "10" /> 
      </StackPanel> 
   </Grid>
   
</Window>

以下是 C# 中针对不同事件的实现：

using System; 
using System.Windows; 
using System.Windows.Controls; 
using System.Windows.Media;

namespace XAMLCheckBox {
   /// <summary> 
      /// Interaction logic for MainWindow.xaml 
   /// </summary>
	public partial class MainWindow : Window { 
      public MainWindow() { 
         InitializeComponent(); 
      }  
      private void HandleCheck(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox; 
			
         if (cb.Name == "cb1") {
            text1.Text = "2 state CheckBox is checked.";
         } else {
            text2.Text = "3 state CheckBox is checked."; 
         }	
      }
      private void HandleUnchecked(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox; 
			
         if (cb.Name == "cb1") {
            text1.Text = "2 state CheckBox is unchecked."; 
         } else {
            text2.Text = "3 state CheckBox is unchecked."; 
         }
      } 
      private void HandleThirdState(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox; 
         text2.Text = "3 state CheckBox is in indeterminate state."; 
      }
   } 
}

编译并执行以上代码后，将产生以下输出：

建议您执行以上示例代码并尝试一些其他属性和事件。

xaml_controls.htm

打印页面