Power Apps 中的 日期选取器 控件
用户可选择以指定日期的控件。
描述
如果添加 日期选取器 控件而非 文本输入 控件,可帮助确保用户以正确的格式指定日期。
关键属性
DefaultDate – 日期控件的初始值(除非用户更改)。
SelectedDate – 日期控件中当前选定的日期。 此日期以本地时间表示。
Format – 控件显示日期和用户指定日期所使用的文本格式。 可以将此属性设置为 ShortDate(默认)或 LongDate,从而根据此控件的 Language 属性设置日期格式。 若要使用相同的格式,而不考虑语言,也可以将此属性设置为表达式(如 yyyy/mm/dd)。 例如:
- 如果用户单击或点击 2017 年的最后一天,Format 属性设置为 ShortDate,且 Language 属性设置为 en-us,那么此控件显示 12/31/2017。
- 如果用户单击或点击 2017 年的最后一天,Format 属性设置为 LongDate,且 Language 属性设置为 fr-fr,那么此控件显示 dimanche 31 decembre 2017。
Language – 确定设置日期格式所使用的语言,包括月份名称。 如果未指定此属性,语言将由用户设备设置决定。 支持的值包括“EN-US”和“FR”。
其他属性
AccessibleLabel – 屏幕阅读器标签。
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
Color – 控件中文本的颜色。
DateTimeZone – 是以 UTC 还是用户的本地时间显示日期。
DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。
DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。
DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。
EndYear – 用户可将日期选取器控件的值设为的最后一个年份。
Fill – 控件的背景色。
FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。
FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。
Font – 文本中所显示的字体系列的名称。
FontWeight – 控件中文本的粗细:Bold、Semibold、Normal 或 Lighter。
Height – 控件上边缘和下边缘之间的距离。
IconFill – 日期选取器图标的前景色。
IconBackground – 日期选取器图标的背景色。
InputTextPlaceholder – 未输入日期时显示的说明文本。
IsEditable – 是否可以编辑日期选择器文本。 如果为 false,则只能使用日历更改日期。
Italic – 控件中的文本是否为斜体。
OnSelect – 当用户点击或单击控件时要执行的操作。
OnChange – 当用户更改控件的值时要执行的操作。
OnChange 和 OnSelect 之间的区别:如果用户的单击引起更改,将在同一个用户操作上触发 OnSelect 和 OnChange。在此情况下,OnSelect 在 OnChange 之前触发。
PaddingBottom – 控件中的文本与该控件下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件上边缘之间的距离。
Reset - 日期选取器 控件是否应重置为 DefaultDate 值。
Size – 控件上显示的文本的字号。
StartOfWeek – 在日期选取器控件的第一天列中显示的星期日期。
StartYear – 用户可将日期选取器控件的值设为的最早年份。
TabIndex – 相对于其他控件的键盘导航顺序。
Visible – 控件显示还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
Year( DateTimeValue )
示例
基本日期选取器
添加日期选取器控件,并将其命名为“Deadline”。
不知道如何添加、命名和配置控件?
添加一个**标签** 控件,然后将 Text 属性设置为以下公式:
DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
按 F5,在 Deadline 中选择一个日期,然后选择确定。
此时,标签 控件显示今天距离所选日期还剩多少天。
要返回默认工作区,按 Esc。
将日期选择器重置为默认日期
添加日期选取器控件,并将其命名为“DateTimeReset”。
不知道如何添加、命名和配置控件?
添加一个**按钮** 控件,然后将 OnChange 属性设置为以下公式:
Reset(DateTimeReset)
按 F5,在 DateTimeReset 中选择一个新日期,然后选择确定。
按此按钮。 日期将重置回 DefaultDate(今天)。
要返回默认工作区,按 Esc。
辅助功能准则
颜色对比度
- 适用标准颜色对比度要求。
屏幕阅读器支持
- AccessibleLabel 必须存在。
- 如果 IsEditable 为 true 并且Format不是用户预期的,请添加一个 标签 来说明可接受的日期格式。
键盘支持
- TabIndex 必须为零或更大,以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 可以使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。
提示
打开日历后,按上一页和下一页在月份之间导航,按 Shift+上一页和 Shift+下一页在年份之间导航。