DatePicker与Calender在某些属性上很相似,只是为了方便显示和操作,DatePicker将Calender进行了封装。
一、DatePicker定义
public class DatePicker : Control
{
public static readonly RoutedEvent SelectedDateChangedEvent;
public static readonly DependencyProperty TextProperty;
public static readonly DependencyProperty SelectedDateFormatProperty;
public static readonly DependencyProperty IsTodayHighlightedProperty;
public static readonly DependencyProperty IsDropDownOpenProperty;
public static readonly DependencyProperty SelectedDateProperty;
public static readonly DependencyProperty DisplayDateStartProperty;
public static readonly DependencyProperty DisplayDateEndProperty;
public static readonly DependencyProperty DisplayDateProperty;
public static readonly DependencyProperty CalendarStyleProperty;
public static readonly DependencyProperty FirstDayOfWeekProperty;
public DatePicker();
public CalendarBlackoutDatesCollection BlackoutDates { get; }
public DateTime? DisplayDateStart { get; set; }
public DateTime? DisplayDateEnd { get; set; }
public DateTime DisplayDate { get; set; }
public Style CalendarStyle { get; set; }
public bool IsTodayHighlighted { get; set; }
public bool IsDropDownOpen { get; set; }
public DatePickerFormat SelectedDateFormat { get; set; }
public string Text { get; set; }
public DayOfWeek FirstDayOfWeek { get; set; }
public DateTime? SelectedDate { get; set; }
protected internal override bool HasEffectiveKeyboardFocus { get; }
public event RoutedEventHandler CalendarClosed;
public event RoutedEventHandler CalendarOpened;
public event EventHandler<SelectionChangedEventArgs> SelectedDateChanged;
public event EventHandler<DatePickerDateValidationErrorEventArgs> DateValidationError;
public override void OnApplyTemplate();
public override string ToString();
protected virtual void OnCalendarClosed(RoutedEventArgs e);
protected virtual void OnCalendarOpened(RoutedEventArgs e);
protected override AutomationPeer OnCreateAutomationPeer();
protected virtual void OnDateValidationError(DatePickerDateValidationErrorEventArgs e);
protected virtual void OnSelectedDateChanged(SelectionChangedEventArgs e);
}
二、属性成员
属性成员 | 说明 |
BlackoutDates | 获取或设置为不可选择的日期的标记集合。不常用。 |
DisplayDateStart | 获取或设置要显示的第一个日期。 |
DisplayDateEnd | 获取或设置要显示的最后日期。 |
DisplayDate | 获取或设置要显示的日期。 |
CalendarStyle | 获取或设置呈现日历时所使用的样式。 |
IsTodayHighlighted | 获取或设置一个值,该值指示是否将突出显示当前日期。 |
IsDropDownOpen | 获取或设置一个值,该值指示Calendar 下拉列表是打开还是关闭。 |
SelectedDateFormat | 获取或设置用于显示所选的日期的格式。 |
Text | 获取DatePicker显示文本,或设置选定的日期 |
FirstDayOfWeek | 获取或设置在一天中被视为周的开始。 |
SelectedDate | 获取或设置当前选定的日期。 |
HasEffectiveKeyboardFocus | 获取一个值,该值指示DatePicker 是否 具有焦点。 |
三、事件成员
事件名称 | 说明 |
CalendarClosed | DatePicker下拉列表关闭时引发此事件 |
CalendarOpened | DatePicker下拉列表打开时引发此事件 |
SelectedDateChanged | SelectedDate属性发生改变时引发此事件 |
DateValidationError | 当Text属性不是日期形式的字符串时引发此事件 |
接下来,我们以一个例子来说明它的用法
四、DatePicker示例
前端代码
<Window x:Class="HelloWorld.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:HelloWorld"
mc:Ignorable="d" FontSize="14"
Title="WPF中文网之控件课程 - www.wpfsoft.com" Height="350" Width="500">
<StackPanel HorizontalAlignment="Center" Margin="30" VerticalAlignment="Center">
<StackPanel Orientation="Horizontal" Margin="10">
<TextBlock Text="开始日期" VerticalAlignment="Center" Margin="10,0"/>
<DatePicker x:Name="_DatePickerStart" VerticalAlignment="Center" Width="120"/>
</StackPanel>
<StackPanel Orientation="Horizontal" Margin="10">
<TextBlock Text="结束日期" VerticalAlignment="Center" Margin="10,0"/>
<DatePicker x:Name="_DatePickerEnd" VerticalAlignment="Center" Width="120"/>
</StackPanel>
<Button Content="查询" Click="Button_Click" Margin="10,0"/>
</StackPanel>
</Window>
后端代码
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private void Button_Click(object sender, RoutedEventArgs e)
{
var selectedDate = $"查询日期:{_DatePickerStart.SelectedDate} {_DatePickerEnd.SelectedDate}\r\n";
var text = $"文本值:{_DatePickerStart.Text} {_DatePickerEnd.Text}";
MessageBox.Show($"{selectedDate} {text}");
}
}
需要注意一点的是,DatePicker的SelectedDate属性是一个DateTime?日期型,而Text属性是一个string类型,所以两者的内容是不相等的。看一下运行结果:
SelectedDate属性后面会带上时分秒信息。
当前课程源码下载:(注明:本站所有源代码请按标题搜索)
文件名:035-《DatePicker日期控件》-源代码
链接:https://pan.baidu.com/s/1yu-q4tUtl0poLVgmcMfgBA
提取码:wpff
——重庆教主 2023年8月31日
Calendar提供一个日历界面,供用户选择日期,它继承于Control基类。
一、Calendar类的定义
public class Calendar : Control
{
public static readonly RoutedEvent SelectedDatesChangedEvent;
public static readonly DependencyProperty SelectionModeProperty;
public static readonly DependencyProperty SelectedDateProperty;
public static readonly DependencyProperty FirstDayOfWeekProperty;
public static readonly DependencyProperty DisplayModeProperty;
public static readonly DependencyProperty DisplayDateStartProperty;
public static readonly DependencyProperty IsTodayHighlightedProperty;
public static readonly DependencyProperty DisplayDateProperty;
public static readonly DependencyProperty CalendarItemStyleProperty;
public static readonly DependencyProperty CalendarDayButtonStyleProperty;
public static readonly DependencyProperty CalendarButtonStyleProperty;
public static readonly DependencyProperty DisplayDateEndProperty;
public Calendar();
public DateTime? DisplayDateStart { get; set; }
public Style CalendarItemStyle { get; set; }
public Style CalendarDayButtonStyle { get; set; }
public Style CalendarButtonStyle { get; set; }
public CalendarBlackoutDatesCollection BlackoutDates { get; }
public CalendarMode DisplayMode { get; set; }
public DateTime? DisplayDateEnd { get; set; }
public bool IsTodayHighlighted { get; set; }
public DateTime? SelectedDate { get; set; }
public SelectedDatesCollection SelectedDates { get; }
public CalendarSelectionMode SelectionMode { get; set; }
public DateTime DisplayDate { get; set; }
public DayOfWeek FirstDayOfWeek { get; set; }
public event EventHandler<SelectionChangedEventArgs> SelectedDatesChanged;
public event EventHandler<CalendarDateChangedEventArgs> DisplayDateChanged;
public event EventHandler<EventArgs> SelectionModeChanged;
public event EventHandler<CalendarModeChangedEventArgs> DisplayModeChanged;
public override void OnApplyTemplate();
public override string ToString();
protected override AutomationPeer OnCreateAutomationPeer();
protected virtual void OnDisplayDateChanged(CalendarDateChangedEventArgs e);
protected virtual void OnDisplayModeChanged(CalendarModeChangedEventArgs e);
protected override void OnKeyDown(KeyEventArgs e);
protected override void OnKeyUp(KeyEventArgs e);
protected virtual void OnSelectedDatesChanged(SelectionChangedEventArgs e);
protected virtual void OnSelectionModeChanged(EventArgs e);
}
二、属性成员
属性名称 | 说明 |
DisplayDateStart | 获取或设置可在日历中的第一个日期。 |
CalendarItemStyle | 获取或设置CalendarItem的样式 |
CalendarDayButtonStyle | 获取或设置CalendarDayButton的样式 |
CalendarButtonStyle | 获取或设置CalendarButton的样式 |
BlackoutDates | 获取标记为不可选择的日期的集合。 |
DisplayMode | 获取或设置一个值,该值指示是否日历显示月、 年或十年。 |
DisplayDateEnd | 获取或设置可在日历中的日期范围内的最后日期。 |
IsTodayHighlighted | 获取或设置一个值,该值指示是否突出显示当前日期。默认true。 |
SelectedDate | 获取或设置当前选定的日期。[重要] |
SelectedDates | 获取选定日期的集合。 |
SelectionMode | 获取或设置一个值,指示允许包含什么样的选择。如果是多选的号,就可以从SelectedDates属性获取所有已选的日期。 |
DisplayDate | 获取或设置要显示的日期。 |
FirstDayOfWeek | 获取或设置在一天中被视为周的开始。 |
三、事件成员
事件名称 | 说明 |
SelectedDatesChanged | 开启多选后,当所选集合的元素数量发生变化时引发 |
DisplayDateChanged | DisplayDate属性被修改后引发 |
SelectionModeChanged | SelectionMode属性(选择模式)发生改变后引发 |
DisplayModeChanged | DisplayMode属性(显示模式)发生改变后引发 |
四、Calendar示例
前端代码
<Window x:Class="HelloWorld.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:HelloWorld"
mc:Ignorable="d" FontSize="14"
Title="WPF中文网之控件课程 - www.wpfsoft.com" Height="350" Width="500">
<StackPanel HorizontalAlignment="Center" Margin="30">
<Calendar x:Name="_Calendar"
HorizontalAlignment="Left"
VerticalAlignment="Top"
Margin="0,15"
DisplayDateStart="2020/1/1 00:00:00"
DisplayDateEnd="2030/1/1 00:00:00"
SelectionMode="MultipleRange"/>
<Button Content="选择" Click="Button_Click"/>
</StackPanel>
</Window>
后端代码
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private void Button_Click(object sender, RoutedEventArgs e)
{
var list = _Calendar.SelectedDates;
var current = _Calendar.SelectedDate;
MessageBox.Show($"当前日期数量:{list.Count},当前日期:{current}");
}
}
我们设置了Calendar的DisplayDateStart和DisplayDateEnd属性,这样将日期的可选范围限制在2020年-2030年之间,同时开启了Calendar多项选择,最后在后端去获取所选的日期集合与当前日期。
当前日期是多选时的第一个日期。
在WPF中还有一个选择日期控件——DatePicker,它对当前这个Calendar控件进行了封装,通常DatePicker会更常用一些。下一节,我们来看看DatePicker控件的用法。
当前课程源码下载:(注明:本站所有源代码请按标题搜索)
文件名:034-《Calendar日历控件》-源代码
链接:https://pan.baidu.com/s/1yu-q4tUtl0poLVgmcMfgBA
提取码:wpff
——重庆教主 2023年8月31日