WPF - 日期选择器

DatePicker 是一种允许用户选择日期值的控件。用户可以通过使用组合框选择月份、日期和年份值来选择日期。DatePicker 类的层次继承如下：

DatePicker 常用属性

以下是 DatePicker 最常用的属性。

序号	属性及描述
1	CalendarIdentifier 获取或设置要使用的日历系统。
2	CalendarIdentifierProperty 获取 CalendarIdentifier 依赖属性的标识符。
3	Date 获取或设置当前在日期选择器中设置的日期。
4	DateProperty 获取 Date 依赖属性的标识符。
5	DayFormat 获取或设置日期值的显示格式。
6	DayFormatProperty 获取 DayFormat 依赖属性的标识符。
7	DayVisible 获取或设置一个值，该值指示是否显示日期选择器。
8	DayVisibleProperty 获取 DayVisible 依赖属性的标识符。
9	Header 获取或设置控件标题的内容。
10	HeaderProperty 标识 Header 依赖属性。
11	HeaderTemplate 获取或设置用于显示控件标题内容的 DataTemplate。
12	HeaderTemplateProperty 标识 HeaderTemplate 依赖属性。
13	MaxYear 获取或设置可供选择的最大公历年份。
14	MaxYearProperty 获取 MaxYear 依赖属性的标识符。
15	MinYear 获取或设置可供选择的最小公历年份。
16	MinYearProperty 获取 MinYear 依赖属性的标识符。
17	MonthFormat 获取或设置月份值的显示格式。
18	MonthFormatProperty 获取 MonthFormat 依赖属性的标识符。
19	MonthVisible 获取或设置一个值，该值指示是否显示月份选择器。
20	MonthVisibleProperty 获取 MonthVisible 依赖属性的标识符。
21	Orientation 获取或设置一个值，该值指示日期、月份和年份选择器是水平堆叠还是垂直堆叠。
22	OrientationProperty 获取 Orientation 依赖属性的标识符。
23	YearFormat 获取或设置年份值的显示格式。
24	YearFormatProperty 获取 YearFormat 依赖属性的标识符。
25	YearVisible 获取或设置一个值，该值指示是否显示年份选择器。
26	YearVisibleProperty 获取 YearVisible 依赖属性的标识符。

DatePicker 类中常用的事件

以下是 DatePicker 最常用的事件。

序号	事件及描述
1	DateChanged 当日期值更改时发生。
2	DragEnter 当输入系统报告以该元素作为目标的基础拖动事件时发生。（继承自 UIElement）
3	DragLeave 当输入系统报告以该元素作为原点的基础拖动事件时发生。（继承自 UIElement）
4	DragOver 当输入系统报告以该元素作为潜在放置目标的基础拖动事件时发生。（继承自 UIElement）
5	DragStarting 当拖动操作开始时发生。（继承自 UIElement）
6	GotFocus 当 UIElement 获取焦点时发生。（继承自 UIElement）
7	Holding 当在此元素的命中测试区域上发生未经处理的 Hold 交互时发生。（继承自 UIElement）
8	IsEnabledChanged 当 IsEnabled 属性更改时发生。（继承自 Control）
9	KeyDown 当 UIElement 具有焦点时按下键盘键时发生。（继承自 UIElement）
10	KeyUp 当 UIElement 具有焦点时释放键盘键时发生。（继承自 UIElement）
11	LostFocus 当 UIElement 失去焦点时发生。（继承自 UIElement）

DatePicker 类中常用的方法

以下是 DatePicker 最常用的方法。

序号	方法及描述
1	ClearValue 清除依赖属性的本地值。（继承自 DependencyObject）
2	FindName 检索具有指定标识符名称的对象。（继承自 FrameworkElement）
3	OnApplyTemplate 每当应用程序代码或内部进程（例如重建布局传递）调用 ApplyTemplate 时都会调用。简单来说，这意味着在 UI 元素在应用程序中显示之前调用该方法。重写此方法以影响类的默认模板后逻辑。（继承自 FrameworkElement）
4	OnDragEnter 在 DragEnter 事件发生之前调用。（继承自 Control）
5	OnDragLeave 在 DragLeave 事件发生之前调用。（继承自 Control）
6	OnDragOver 在 DragOver 事件发生之前调用。（继承自 Control）
7	OnDrop 在 Drop 事件发生之前调用。（继承自 Control）
8	OnGotFocus 在 GotFocus 事件发生之前调用。（继承自 Control）
9	OnKeyDown 在 KeyDown 事件发生之前调用。（继承自 Control）
10	OnKeyUp 在 KeyUp 事件发生之前调用。（继承自 Control）
11	OnLostFocus 在 LostFocus 事件发生之前调用。（继承自 Control）
12	SetBinding 使用提供的绑定对象将绑定附加到 FrameworkElement。（继承自 FrameworkElement）

示例

让我们创建一个名为 **WPFDatePickerControl** 的新 WPF 项目。
从工具箱中拖动一个 DatePicker。
以下示例演示如何创建 DatePicker 控件。
当您从 DatePicker 控件中点击任何日期时，程序将使用该日期更新标题。
以下 XAML 代码创建了一个具有某些属性和点击事件的 DatePicker。

<Window x:Class = "WPFDatePickerControl.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> 
      <DatePicker HorizontalAlignment = "Center" Margin = "10,10,0,0" 
         VerticalAlignment = "Top" SelectedDateChanged = "DatePicker_SelectedDateChanged"/> 
   </Grid> 
	
</Window>

这是 **DatePicker_SelectedDateChanged** 事件的 **C# 实现**。

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

namespace WPFDatePickerControl { 

   public partial class MainWindow : Window { 
	
      public MainWindow() { 
         InitializeComponent(); 
      } 
		
      private void DatePicker_SelectedDateChanged(object sender, SelectionChangedEventArgs e) { 
         var picker = sender as DatePicker;  
         DateTime? date = picker.SelectedDate;
			
         if (date == null) { 
            this.Title = "No date"; 
         } 
         else { 
            this.Title = date.Value.ToShortDateString(); 
         } 
      } 
   }
	
}

当您编译并执行上述代码时，它将生成以下窗口。

我们建议您执行上述示例代码并尝试 DatePicker 类的其他一些属性和事件。

wpf_controls.htm

打印页面