Calendar 控制
用于输入日期值的控件。
备注
GitHub 代码组件存储库中的完整文档和源代码。
说明
此代码组件提供了一个围绕绑定到按钮的 Fluent UI Calendar 控件的包装器，用于画布和自定义页面。
属性
键属性
| 属性 | 说明 |
|---|---|
SelectedDateValue |
要预先选择或在更改事件后选择的日期值。 例如：今天的日期：Today()，基于语言的日期：DateValue("24/7/2022",Language())，特定区域语言：DateValue("24/07/2022","en-GB") |
ShowGoToToday |
“转到今天”选项是否可见 |
MonthPickerVisible |
月份选取器是否可见 |
DayPickerVisible |
日期选取器是否可见 |
HighlightSelectedMonth |
所选月份是否在日历中突出显示 |
HighlightCurrentMonth |
当前月份是否在日历中突出显示 |
ShowWeekNumbers |
周数是否可见 |
ShowSixWeeksByDefault |
第六周是否默认可见。 |
MinDate |
如果指定了日期值，将不允许导航超出该日期。 有关正确的格式，请参考为所选日期提供的示例。 |
MaxDate |
如果指定了日期值，将不允许导航超出该日期。 有关正确的格式，请参考为所选日期提供的示例。 |
FirstDayOfWeek |
选择要在日历中显示为一周的第一天的日期。 |
样式属性
| 属性 | 说明 |
|---|---|
Theme |
接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。 有关如何配置的指导，请参阅主题化。 |
BackgroundColor |
组件的背景色。 例如，White 或 #ffffff |
AccessibilityLabel |
屏幕阅读器 aria 标签 |
事件属性
| 属性 | 说明 |
|---|---|
InputEvent |
要发送到控件的事件。 例如，SetFocus。 请参阅以下内容。 |
行为
支持 SetFocus 作为 InputEvent。
使用 OnChange
选择日期时，可以通过 selectedDate 输出属性获取值。 下面是一组示例代码，可以添加到“OnChange”属性中，具体取决于需要可视化的输出如何进行。
Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, ShortDate, Language())));
// Example - Output: 7/14/2022
Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, LongDate, Language())));
// Example - Output: Sunday, July 3, 2022
Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, ShortDate, "en-GB")));
// Example - Output: 14/07/2022
将焦点设置在控件上
当显示一个新对话，并且默认焦点应在控件上时，需要显式设置焦点。
要调用输入事件，您可以将绑定到 Input Event 属性的上下文变量设置为以 SetFocus 开头、后跟随机元素的字符串，以确保应用将其检测为更改。
Power Fx 公式示例：
UpdateContext({ctxResizableTextareaEvent:"SetFocus" & Text(Rand())}));
上下文变量 ctxResizableTextareaEvent 然后将被绑定到属性 InputEvent。
限制
此代码组件只能在画布应用和自定义页面中使用。