日历日期选取器

日历日期选取器是一个下拉式控件，该控件已针对从日历视图中选取某个日期进行了优化，尤其是能够显示诸如星期几或丰富的日历信息等上下文信息。 可以修改日历以提供其他上下文或限制可用日期。

这是正确的控件吗？

使用 日历日期选取器 允许用户从上下文日历视图中选取单个日期。 将其用于选择约会或出发日期等内容。

若要让用户选取已知日期（例如出生日期），其中日历上下文不重要，请考虑使用 日期选取器。

有关选择正确控件的详细信息，请参阅 日期和时间控件 文章。

示例

如果尚未设置日期，入口点将显示占位符文本;否则，它将显示所选日期。 当用户选择入口点时，日历视图将展开供用户选择日期。 日历视图覆盖其他 UI;它不会以这种方式推送其他 UI。

日历日期选取器的屏幕截图，显示一个空的选择日期文本框，随后在其下方显示了一个日历。

创建日历日期选取器

WinUI 3 画廊应用包含大多数 WinUI 3 控件、特性和功能的交互式示例。 从 Microsoft 应用商店获取应用或在 GitHub 上获取源代码

<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Calendar"/>

CalendarDatePicker arrivalCalendarDatePicker = new CalendarDatePicker();
arrivalCalendarDatePicker.Header = "Calendar";

生成的日历日期选取器如下所示：

日历日期选取器具有用于选取日期的内部 CalendarView 。 CalendarDatePicker 上存在一部分 CalendarView 属性（如 IsTodayHighlighted 和 FirstDayOfWeek），并转发到内部 CalendarView，以便对其进行修改。

但是，不能更改内部 CalendarView 的 SelectionMode 以允许多个选择。 如果需要让用户选取多个日期或需要始终可见日历，请考虑使用日历视图而不是日历日期选取器。 有关如何修改日历显示的详细信息，请参阅 日历视图 文章。

选择日期

使用 Date 属性获取或设置所选日期。 默认情况下，Date 属性为 null。 当用户在日历视图中选择日期时，将更新此属性。 用户可以通过单击日历视图中的选定日期取消选中日期来清除日期。

可以在代码中设置如下所示的日期。

myCalendarDatePicker.Date = new DateTime(1977, 1, 5);

在代码中设置 Date 时，该值受 MinDate 和 MaxDate 属性的约束。

• 如果 Date 小于 MinDate，则该值设置为 MinDate。
• 如果 Date 大于 MaxDate，则该值设置为 MaxDate。

可以处理 DateChanged 事件，以在 Date 值更改时收到通知。

设置标题和占位符文本

可以将 标头 （或标签）和 PlaceholderText （或水印）添加到日历日期选取器，以便向用户指示其用途。 若要自定义标头的外观，可以设置 HeaderTemplate 属性而不是 Header。

默认占位符文本为“选择日期”。 可以通过将 PlaceholderText 属性设置为空字符串来删除此功能，也可以提供自定义文本，如下所示。

<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Arrival date"
                    PlaceholderText="Choose your arrival date"/>

UWP 和 WinUI 2

此控件的 API 存在于 Windows.UI.Xaml.Controls 命名空间中。

建议使用最新的 WinUI 2 来获取所有控件的最新样式和模板。 WinUI 2.2 或更高版本包含此控件的使用圆角的新模板。 有关详细信息，请参阅 角半径。

相关文章

• 日期和时间控件
• 日历视图
• 日期选取器
• 时间选取器