XAML - DatePicker

更新于 2024/6/13 10:47:57

DatePicker 表示允许用户选择日期值的控件。用户使用 ComboBox 选择月、日和年值来选择日期。DatePicker 类的层次继承如下 −

属性

下面给出了 DatePicker 的一些最常用的属性。

Sr.No.	属性 &描述
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 类中的事件。

Sr.No.	事件和说明
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 类中最常用的方法。

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

示例

以下示例显示如何创建 DatePicker 控件。当您单击 DatePicker 控件中的任何日期时，程序将使用该日期更新标题。

以下是创建具有一些属性和单击事件的 DatePicker 的 XAML 代码。

<Window x:Class = "XAMLDatePicker.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; 
System.Windows.Controls;

namespace XAMLDatePicker { 
   /// <summary> 
      /// Interaction logic for MainWindow.xaml 
   /// </summary> 
	
   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(); 
         } 
      }
   }
}

当你编译并执行上面的代码时，将会显示以下输出−