CalendarDatePicker 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示允许用户从日历显示中选择日期的控件。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CalendarDatePicker : Control
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CalendarDatePicker : Control
Public Class CalendarDatePicker
Inherits Control
- 继承
- 属性
示例
Tip
有关详细信息、设计指南和代码示例,请参阅 日历日期选取器。
WinUI 3 示例集应用程序包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用,或在 GitHub 上获取源代码
注解
CalendarDatePicker 是一个下拉控件,它针对从日历视图中选取单个日期而优化,在这种情况下,上下文信息(如星期几或日历的完整性)非常重要。 它类似于 DatePicker 控件,但 DatePicker 已针对选取已知日期(如出生日期)进行优化,其中日历上下文不重要。
可以使用其默认形式的 CalendarDatePicker 控件,只需少量的可扩展应用程序标记语言(XAML)或其他代码,也可以通过各种方式对其进行自定义以适合你的应用。 下面是在可扩展应用程序标记语言(XAML)和代码中创建的简单 CalendarDatePicker。
CalendarDatePicker arrivalCalendarDatePicker = new CalendarDatePicker();
<CalendarDatePicker x:Name="arrivalCalendarDatePicker"/>
下面是控件关闭时的外观,并且未选择日期。
下面是日历打开和所选日期的外观。
CalendarDatePicker 具有用于选取日期的内部 CalendarView 。 CalendarDatePicker 上存在 一部分 CalendarView 属性(如 IsTodayHighlighted 和 FirstDayOfWeek),并转发到内部 CalendarView ,以便对其进行修改。 但是,不能更改内部 CalendarView 的 SelectionMode 以允许多个选择。 如果需要让用户选取多个日期或需要始终可见的日历,请考虑使用 CalendarView 而不是 CalendarDatePicker。 有关如何修改日历显示的详细信息,请参阅 CalendarView 类。
选择日期
使用 Date 属性获取或设置所选日期。 默认情况下, Date 属性为 null。 当用户在日历视图中选择日期时,将更新此属性。 用户可以通过单击日历视图中已选择的日期来取消选择,从而清除日期。
可以在代码中设置如下所示的日期。
myCalendarDatePicker.Date = new DateTime(1977, 1, 5);
在代码中设置 Date 时,该值受 MinDate 和 MaxDate 属性的约束。 如果 Date 小于 MinDate,则该值设置为 MinDate。 如果 Date 大于 MaxDate,则该值设置为 MaxDate。
可以处理 DateChanged 事件,以在 Date 值更改时收到通知。
设置所选日期的格式
可以更改所选日期的日期、月份和年份的显示格式。 CalendarDatePicker 的 TextBox 部分的字符串内容由 DateTimeFormatter 创建。 通过提供格式模板或格式模式的字符串,告知 DateTimeFormatter 如何设置值的格式。 有关格式模板和格式模式的完整列表,请参阅 DateTimeFormatter 类文档的“备注”部分。
下面介绍如何使用格式模式在 XAML 和代码中指定格式。
<CalendarDatePicker x:Name="myCalendarDatePicker"
DateFormat = "{}{dayofweek.full}, {month.full} {day.integer}, {year.full}"/>
myCalendarDatePicker.DateFormat = "{dayofweek.full}, {month.full} {day.integer}, {year.full}";
所选日期类似于带格式的日期。
设置标题和占位符文本
可以将 Header (或标签)和 PlaceholderText (或水印)添加到 CalendarDatePicker,以便向用户指示其用途。 若要自定义标头的外观,可以设置 HeaderTemplate 属性而不是 Header。 有关设计信息,请参阅 标签指南。
默认占位符文本为“选择日期 ”。 可以通过将 PlaceholderText 属性设置为空字符串来删除此功能,也可以提供自定义文本,如下所示。
<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Arrival date" PlaceholderText="Choose your arrival date"/>
全球化
CalendarDatePicker 支持Windows支持的每个日历系统。 这些日历在 Windows.Globalization.CalendarIdentifiers 类中指定。 CalendarDatePicker 为应用的默认语言使用正确的日历,也可以将 CalendarIdentifier 属性设置为使用特定的日历系统。
日期时间和 Calendar 值
CalendarDatePicker 中使用的日期对象具有不同的表示形式,具体取决于编程语言。 C# 使用属于.NET一部分的 System.DateTimeOffset 结构。 C++ 使用 Windows。Foundation.DateTime 结构。 相关概念是 Calendar 类,它影响日期在上下文中的解释方式。 所有 Windows 运行时应用都可以使用 Windows.Globalization.Calendar 类。 C# 应用也可以使用 System.Globalization.Calendar 类,该类具有非常相似的功能。 (Windows Runtime应用可以使用 base .NET Calendar 类,但不能使用特定实现;例如,GregorianCalendar.
.NET 还支持名为 DateTime 的类型,该类型可隐式转换为 DateTimeOffset。 因此,你可能会在.NET代码中看到一种“DateTime”类型,该类型用于设置真正DateTimeOffset的值。 有关 DateTime 和 DateTimeOffset 之间的差异的详细信息,请参阅 DateTimeOffset 中的备注。
注释
不能将日期对象设置为 XAML 属性字符串的属性,因为Windows Runtime XAML 分析程序没有将字符串转换为日期的转换逻辑,因为DateTime/DateTimeOffset 对象。 通常在代码中设置这些值。 另一种可能的技术是定义一个可以作为数据对象或在数据上下文中使用的日期,然后将该属性设置为一个 XAML 属性,该属性引用一个 {Binding} 标记扩展 表达式,该表达式能够以数据形式访问日期。
控件样式和模板
可以修改默认 样式 和 ControlTemplate ,使控件具有唯一的外观。 有关修改控件样式和模板的信息,请参阅 XAML 样式。 定义控件外观的默认样式、模板和资源包含在 generic.xaml 文件中。 出于设计目的,generic.xaml随 Windows App SDK NuGet 包一起安装。 默认情况下,此位置是 \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml。 不同版本的 SDK 的样式和资源可能具有不同的值。
XAML 还包括可用于在不修改控件模板的情况下在不同视觉状态中修改控件颜色的资源。 修改这些资源是设置 背景 和 前台等属性的首选。 有关详细信息,请参阅 XAML 样式文章的“轻量级样式”部分。
构造函数
| 名称 | 说明 |
|---|---|
| CalendarDatePicker() |
初始化 CalendarDatePicker 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AccessKey |
获取或设置此元素的访问键(助记)。 (继承自 UIElement) |
| AccessKeyScopeOwner |
获取或设置一个源元素,该元素提供此元素的访问键范围,即使它不在源元素的可视化树中也是如此。 (继承自 UIElement) |
| ActualHeight |
获取 FrameworkElement 的呈现高度。 请参阅“备注”。 (继承自 FrameworkElement) |
| ActualOffset |
获取此 UIElement 相对于其父级的位置,该位置是在布局过程的排列传递期间计算的。 (继承自 UIElement) |
| ActualSize |
获取此 UIElement 在布局过程的排列传递期间计算的大小。 (继承自 UIElement) |
| ActualTheme |
获取元素当前使用的 UI 主题,该主题可能与 RequestedTheme 不同。 (继承自 FrameworkElement) |
| ActualWidth |
获取 FrameworkElement 的呈现宽度。 请参阅“备注”。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值,该值确定此 UIElement 是否可以作为拖放操作的放置目标。 (继承自 UIElement) |
| AllowFocusOnInteraction |
获取或设置一个值,该值指示当用户与其交互时元素是否自动获得焦点。 (继承自 FrameworkElement) |
| AllowFocusWhenDisabled |
获取或设置禁用的控件是否可以接收焦点。 (继承自 FrameworkElement) |
| Background |
获取或设置提供控件背景的画笔。 (继承自 Control) |
| BackgroundSizing |
获取或设置一个值,该值指示背景相对于此元素边框的扩展距离。 (继承自 Control) |
| BaseUri |
获取一个统一资源标识符(URI),该标识符表示 XAML 加载时 XAML 构造对象的基 URI。 此属性适用于运行时的 URI 解析。 (继承自 FrameworkElement) |
| BorderBrush |
获取或设置描述控件边框填充的画笔。 (继承自 Control) |
| BorderThickness |
获取或设置控件的边框粗细。 (继承自 Control) |
| CacheMode |
获取或设置一个值,该值指示应尽可能将呈现的内容缓存为复合位图。 (继承自 UIElement) |
| CalendarIdentifier |
获取或设置要使用的日历系统。 |
| CalendarIdentifierProperty |
标识 CalendarIdentifier 依赖项属性。 |
| CalendarViewStyle |
获取或设置与控件的内部 CalendarView 对象关联的 Style。 |
| CalendarViewStyleProperty |
标识 CalendarViewStyle 依赖项属性。 |
| CanBeScrollAnchor |
获取或设置一个值,该值指示 UIElement 是否可以成为滚动定位的候选项。 (继承自 UIElement) |
| CanDrag |
获取或设置一个值,该值指示是否可以在拖放操作中将元素作为数据拖动。 (继承自 UIElement) |
| CenterPoint |
获取或设置元素的中心点,即发生旋转或缩放的点。 影响元素的呈现位置。 (继承自 UIElement) |
| CharacterSpacing |
获取或设置字符之间的统一间距,单位为 1/1000 em。 (继承自 Control) |
| Clip |
获取或设置用于定义 UIElement 内容的轮廓的 RectangleGeometry。 (继承自 UIElement) |
| CompositeMode |
获取或设置一个属性,该属性在其父布局和窗口中声明元素的备用组合和混合模式。 这与混合 XAML/Microsoft DirectX UI 中涉及的元素相关。 (继承自 UIElement) |
| ContextFlyout |
获取或设置与此元素关联的浮出控件。 (继承自 UIElement) |
| CornerRadius |
获取或设置控件边框的角的半径。 (继承自 Control) |
| DataContext |
获取或设置 FrameworkElement 的数据上下文。 数据上下文的常见用途是 |
| Date |
获取或设置日历选取器中当前设置的日期。 |
| DateFormat |
获取或设置选取器文本框中日期值的显示格式。 |
| DateFormatProperty |
标识 DateFormat 依赖项属性。 |
| DateProperty |
标识 Date 依赖属性。 |
| DayOfWeekFormat |
获取或设置选取器 CalendarView 中星期几标题的显示格式。 |
| DayOfWeekFormatProperty |
标识 DayOfWeekFormat 依赖项属性。 |
| DefaultStyleKey |
获取或设置引用控件的默认样式的键。 自定义控件的作者使用此属性更改其控件使用的样式的默认值。 (继承自 Control) |
| DefaultStyleResourceUri |
获取或设置包含控件的默认样式的资源文件的路径。 (继承自 Control) |
| Description |
获取或设置控件下方显示的内容。 内容应提供有关控件预期输入的指导。 |
| DescriptionProperty |
标识 Description 依赖属性。 |
| DesiredSize |
获取此 UIElement 在布局过程的度量传递期间计算的大小。 (继承自 UIElement) |
| Dispatcher |
始终在 Windows 应用 SDK 应用中返回 |
| DispatcherQueue |
获取 |
| DisplayMode |
获取或设置一个值,该值指示日历是否显示选取器 CalendarView 中月份、年份或十年的选定内容。 |
| DisplayModeProperty |
标识 DisplayMode 依赖项属性。 |
| ElementSoundMode |
获取或设置一个值,该值指定控件是否播放声音的首选项。 (继承自 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
获取或设置一个值,该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 UIElement) |
| FirstDayOfWeek |
获取或设置一个值,该值指示哪一天显示为选取器 CalendarView 中星期的第一天。 |
| FirstDayOfWeekProperty |
标识 FirstDayOfWeek 依赖属性。 |
| FlowDirection |
获取或设置文本和其他 UI 元素在控制布局的任何父元素中流动的方向。 此属性可以设置为或 |
| FocusState |
获取一个值,该值指定此控件是否具有焦点,以及获取焦点的模式。 (继承自 UIElement) |
| FocusVisualMargin |
获取或设置 FrameworkElement 焦点视觉对象的外部边距。 (继承自 FrameworkElement) |
| FocusVisualPrimaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualPrimaryThickness |
获取或设置 FrameworkElement 的外边框或 |
| FocusVisualSecondaryBrush |
获取或设置用于为 FrameworkElement 绘制或 |
| FocusVisualSecondaryThickness |
获取或设置 FrameworkElement 的框架视觉对象内边框的 |
| FontFamily |
获取或设置用于在控件中显示文本的字体。 (继承自 Control) |
| FontSize |
获取或设置此控件中文本的大小。 (继承自 Control) |
| FontStretch |
获取或设置字体在屏幕上凝结或展开的程度。 (继承自 Control) |
| FontStyle |
获取或设置呈现文本的样式。 (继承自 Control) |
| FontWeight |
获取或设置指定字体的粗细。 (继承自 Control) |
| Foreground |
获取或设置描述前景色的画笔。 (继承自 Control) |
| Header |
获取或设置日历选取器标题的内容。 |
| HeaderProperty |
标识 标头 依赖项属性。 |
| HeaderTemplate |
获取或设置用于显示标头内容的 DataTemplate 。 |
| HeaderTemplateProperty |
标识 HeaderTemplate 依赖项属性。 |
| Height |
获取或设置 FrameworkElement 的建议高度。 (继承自 FrameworkElement) |
| HighContrastAdjustment |
获取或设置一个值,该值指示在启用高对比度主题时框架是否自动调整元素的视觉属性。 (继承自 UIElement) |
| HorizontalAlignment |
获取或设置在布局父级(如面板或项控件)中组合时应用于 FrameworkElement 的水平对齐特征。 (继承自 FrameworkElement) |
| HorizontalContentAlignment |
获取或设置控件内容的水平对齐方式。 (继承自 Control) |
| IsAccessKeyScope |
获取或设置一个值,该值指示元素是否定义其自己的访问密钥范围。 (继承自 UIElement) |
| IsCalendarOpen |
获取或设置一个值,该值指示是否当前显示 CalendarDatePicker 的日历视图。 |
| IsCalendarOpenProperty |
标识 IsCalendarOpen 依赖项属性。 |
| IsDoubleTapEnabled |
获取或设置一个值,该值确定 DoubleTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值,该值指示用户是否可以与控件交互。 (继承自 Control) |
| IsFocusEngaged |
获取或设置一个值,该值指示当用户按下游戏控制器上的 A/Select 按钮时焦点是否受限于控件。 (继承自 Control) |
| IsFocusEngagementEnabled |
获取或设置一个值,该值指示当用户按下游戏控制器上的 A/Select 按钮时是否可以将焦点限制为控件。 (继承自 Control) |
| IsGroupLabelVisible |
获取或设置一个值,该值指示月份名称是否与选取器 CalendarView 中月份的第一天一起显示。 |
| IsGroupLabelVisibleProperty |
标识 IsGroupLabelVisible 依赖项属性。 |
| IsHitTestVisible |
获取或设置此 UIElement 的包含区域是否可以返回命中测试的真实值。 (继承自 UIElement) |
| IsHoldingEnabled |
获取或设置一个值,该值确定 Holding 事件是否可以源自该元素。 (继承自 UIElement) |
| IsLoaded |
获取一个值,该值指示是否已将元素添加到元素树中并已准备好进行交互。 (继承自 FrameworkElement) |
| IsOutOfScopeEnabled |
获取或设置一个值,该值指示是否在选取器 CalendarView 中使用唯一的前景色显示范围外日历项目。 |
| IsOutOfScopeEnabledProperty |
标识 IsOutOfScopeEnabled 依赖属性。 |
| IsRightTapEnabled |
获取或设置一个值,该值确定 RightTapped 事件是否可以源自该元素。 (继承自 UIElement) |
| IsTabStop |
获取或设置一个值,该值指示控件是否包含在选项卡导航中。 (继承自 UIElement) |
| IsTapEnabled |
获取或设置一个值,该值确定 点击 事件是否可以源自该元素。 (继承自 UIElement) |
| IsTextScaleFactorEnabled |
获取或设置是否启用自动文本放大,以反映系统文本大小设置。 (继承自 Control) |
| IsTodayHighlighted |
获取或设置一个值,该值指示当前日期是否在选取者的 CalendarView 中突出显示。 |
| IsTodayHighlightedProperty |
标识 IsTodayHighlighted 依赖属性。 |
| KeyboardAcceleratorPlacementMode |
获取或设置一个值,该值指示控件 工具提示 是否显示其关联的键盘加速器的键组合。 (继承自 UIElement) |
| KeyboardAcceleratorPlacementTarget |
获取或设置一个值,该值指示显示快捷键组合的控件 工具提示 。 (继承自 UIElement) |
| KeyboardAccelerators |
获取使用键盘调用操作的键组合的集合。 加速器通常分配给按钮或菜单项。
|
| KeyTipHorizontalOffset |
获取或设置一个值,该值指示键提示相对于 UIElement 放置的距离。 (继承自 UIElement) |
| KeyTipPlacementMode |
获取或设置一个值,该值指示访问键提示相对于 UIElement 边界的位置。 (继承自 UIElement) |
| KeyTipTarget |
获取或设置一个值,该值指示访问键提示面向的元素。 (继承自 UIElement) |
| KeyTipVerticalOffset |
获取或设置一个值,该值指示键提示相对于 UI 元素的向上或向下放置距离。 (继承自 UIElement) |
| Language |
获取或设置适用于 FrameworkElement 的本地化/全球化语言信息,以及应用于对象表示形式和 UI 中当前 FrameworkElement 的所有子元素。 (继承自 FrameworkElement) |
| LightDismissOverlayMode |
获取或设置一个值,该值指定浅 色消除 UI 外部的区域是否变暗。 |
| LightDismissOverlayModeProperty |
标识 LightDismissOverlayMode 依赖项属性。 |
| Lights |
获取附加到此元素的 XamlLight 对象的集合。 (继承自 UIElement) |
| ManipulationMode |
获取或设置用于 UIElement 行为和与手势交互的 ManipulationModes 值。 设置此值可在应用代码中处理此元素中的操作事件。 (继承自 UIElement) |
| Margin |
获取或设置 FrameworkElement 的外部边距。 (继承自 FrameworkElement) |
| MaxDate |
获取或设置可在选取器中设置的最新日期。 |
| MaxDateProperty |
标识 MaxDate 依赖项属性。 |
| MaxHeight |
获取或设置 FrameworkElement 的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置 FrameworkElement 的最大宽度约束。 (继承自 FrameworkElement) |
| MinDate |
获取或设置可在选取器中设置的最早日期。 |
| MinDateProperty |
标识 MinDate 依赖项属性。 |
| MinHeight |
获取或设置 FrameworkElement 的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置 FrameworkElement 的最小宽度约束。 (继承自 FrameworkElement) |
| Name |
获取或设置对象的标识名称。 当 XAML 处理器从 XAML 标记创建对象树时,运行时代码可以通过此名称引用 XAML 声明的对象。 (继承自 FrameworkElement) |
| Opacity |
获取或设置对象的不透明度程度。 (继承自 UIElement) |
| OpacityTransition |
获取或设置对 Opacity 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
| Padding |
获取或设置控件内的填充。 (继承自 Control) |
| Parent |
获取对象树中此 FrameworkElement 的父对象。 (继承自 FrameworkElement) |
| PlaceholderText |
获取或设置在选取器文本框中显示的文本,直到用户操作或其他操作更改值为止。 |
| PlaceholderTextProperty |
标识 PlaceholderText 依赖项属性。 |
| PointerCaptures |
获取所有捕获的指针集,这些指针表示为 指针 值。 (继承自 UIElement) |
| Projection |
获取或设置呈现此元素时要应用的透视投影(三维效果)。 (继承自 UIElement) |
| ProtectedCursor |
获取或设置指针位于此元素上时显示的游标。 默认值为 null,表示游标没有更改。 (继承自 UIElement) |
| RasterizationScale |
获取一个值,该值表示在呈现形状、图像、文本或媒体时要使用的额外比例因子,通常以比正常分辨率更高的分辨率呈现。 (继承自 UIElement) |
| RenderSize |
获取 UIElement 的最终呈现大小。 不建议使用,请参阅“备注”。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响 UIElement 呈现位置的转换信息。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置 RenderTransform 声明的任何可能的呈现转换的原点,相对于 UIElement 的边界。 (继承自 UIElement) |
| RequestedTheme |
获取或设置 UIElement (及其子元素)用于资源确定的 UI 主题。 你指定的 |
| RequiresPointer |
获取或设置 UI 元素是否支持鼠标模式,该模式模拟与非指针输入设备(如键盘或游戏控制器)的指针交互体验。 (继承自 Control) |
| Resources |
获取本地定义的资源字典。 在 XAML 中,可以通过 XAML 隐式集合语法将资源项作为属性元素的 |
| Rotation |
获取或设置顺时针旋转的角度(以度为单位)。 相对于 RotationAxis 和 CenterPoint 旋转。 影响元素的呈现位置。 (继承自 UIElement) |
| RotationAxis |
获取或设置要围绕元素旋转的轴。 (继承自 UIElement) |
| RotationTransition |
获取或设置对 Rotation 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
| Scale |
获取或设置元素的规模。 相对于元素的 CenterPoint 进行缩放。 影响元素的呈现位置。 (继承自 UIElement) |
| ScaleTransition |
获取或设置 Vector3Transition,该 Vector3Transition 对 Scale 属性的更改进行动画处理。 (继承自 UIElement) |
| Shadow |
获取或设置元素强制转换的阴影效果。 (继承自 UIElement) |
| Style |
获取或设置在布局和呈现期间应用于此对象的实例 样式 。 (继承自 FrameworkElement) |
| TabFocusNavigation |
获取或设置一个值,该值修改 Tabbing 和 TabIndex 对此控件的工作方式。 (继承自 UIElement) |
| TabIndex |
获取或设置一个值,该值确定当用户使用 Tab 键浏览控件时元素接收焦点的顺序。 (继承自 UIElement) |
| TabNavigation |
获取或设置一个值,该值修改 Tabbing 和 UIElement.TabIndex 对此控件的工作方式。 注释 对于Windows 10创意者更新(内部版本 10.0.15063)及更新版本, TabFocusNavigation 属性在 UIElement 基类上可用,以在不使用 ControlTemplate 的制表符序列中包含对象。 |
| Tag |
获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 FrameworkElement) |
| Template |
获取或设置控件模板。 控件模板定义 UI 中控件的视觉外观,并在 XAML 标记中定义。 (继承自 Control) |
| Transform3D |
获取或设置呈现此元素时要应用的三维转换效果。 (继承自 UIElement) |
| TransformMatrix |
获取或设置要应用于元素的转换矩阵。 (继承自 UIElement) |
| Transitions |
获取或设置应用于 UIElement 的 Transition 样式元素的集合。 (继承自 UIElement) |
| Translation |
获取或设置元素的 x、y 和 z 呈现位置。 (继承自 UIElement) |
| TranslationTransition |
获取或设置 Vector3Transition,该 Vector3Transition 对翻译属性的更改进行动画处理。 (继承自 UIElement) |
| Triggers |
获取为 FrameworkElement 定义的动画的触发器集合。 不常用。 请参阅“备注”。 (继承自 FrameworkElement) |
| UseLayoutRounding |
获取或设置一个值,该值确定对象及其视觉子树的呈现是否应使用将呈现与整个像素对齐的舍入行为。 (继承自 UIElement) |
| UseSystemFocusVisuals |
获取或设置一个值,该值指示控件是使用由系统绘制的焦点视觉对象还是控件模板中定义的焦点视觉对象。 (继承自 UIElement) |
| VerticalAlignment |
获取或设置在父对象(如面板或项控件)中组合时应用于 FrameworkElement 的垂直对齐特征。 (继承自 FrameworkElement) |
| VerticalContentAlignment |
获取或设置控件内容的垂直对齐方式。 (继承自 Control) |
| Visibility |
获取或设置 UIElement 的可见性。 不可见的元素 |
| Width |
获取或设置 FrameworkElement 的宽度。 (继承自 FrameworkElement) |
| XamlRoot |
获取或设置 |
| XYFocusDown |
获取或设置当用户按下游戏控制器方向盘(D 板)时获得焦点的对象。 (继承自 UIElement) |
| XYFocusDownNavigationStrategy |
获取或设置一个值,该值指定用于确定向下导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusKeyboardNavigation |
获取或设置一个值,该值使用键盘方向箭头启用或禁用导航。 (继承自 UIElement) |
| XYFocusLeft |
获取或设置当用户向左按下游戏控制器方向盘(D 板)时获得焦点的对象。 (继承自 UIElement) |
| XYFocusLeftNavigationStrategy |
获取或设置一个值,该值指定用于确定左侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusRight |
获取或设置当用户向右按下游戏控制器方向面板(D 板)时获取焦点的对象。 (继承自 UIElement) |
| XYFocusRightNavigationStrategy |
获取或设置一个值,该值指定用于确定右侧导航的目标元素的策略。 (继承自 UIElement) |
| XYFocusUp |
获取或设置当用户按下游戏控制器方向面板(D 板)时获得焦点的对象。 (继承自 UIElement) |
| XYFocusUpNavigationStrategy |
获取或设置一个值,该值指定用于确定向上导航的目标元素的策略。 (继承自 UIElement) |
方法
活动
| 名称 | 说明 |
|---|---|
| AccessKeyDisplayDismissed |
在不再显示访问密钥时发生。 (继承自 UIElement) |
| AccessKeyDisplayRequested |
当用户请求显示访问密钥时发生。 (继承自 UIElement) |
| AccessKeyInvoked |
当用户完成访问密钥序列时发生。 (继承自 UIElement) |
| ActualThemeChanged |
在 ActualTheme 属性值发生更改时发生。 (继承自 FrameworkElement) |
| BringIntoViewRequested |
在此元素或其子代之一上调用 StartBringIntoView 时发生。 (继承自 UIElement) |
| CalendarViewDayItemChanging |
在选取器 CalendarView 中加载 CalendarViewDayItem 时发生。 |
| CharacterReceived |
当输入队列接收单个组合字符时发生。 (继承自 UIElement) |
| Closed |
隐藏选取器 CalendarView 时发生。 |
| ContextCanceled |
当上下文输入手势继续进入操作手势时发生,以通知元素不应打开上下文浮出控件。 (继承自 UIElement) |
| ContextRequested |
当用户完成上下文输入手势(例如右键单击)时发生。 (继承自 UIElement) |
| DataContextChanged |
当 FrameworkElement.DataContext 属性的值更改时发生。 (继承自 FrameworkElement) |
| DateChanged |
更改日期值时发生。 |
| DoubleTapped |
在此元素的命中测试区域发生其他未经处理的 DoubleTap 交互时发生。 (继承自 UIElement) |
| DragEnter |
当输入系统报告具有此元素作为目标的基础拖动事件时发生。 (继承自 UIElement) |
| DragLeave |
当输入系统报告具有此元素作为源的基础拖动事件时发生。 (继承自 UIElement) |
| DragOver |
当输入系统将具有此元素的基础拖动事件报告为潜在放置目标时发生。 (继承自 UIElement) |
| DragStarting |
在启动拖动操作时发生。 (继承自 UIElement) |
| Drop |
当输入系统将此元素作为放置目标报告基础删除事件时发生。 (继承自 UIElement) |
| DropCompleted |
在结束源时使用此元素执行拖放操作时发生。 (继承自 UIElement) |
| EffectiveViewportChanged |
在 FrameworkElement的有效视区 更改时发生。 (继承自 FrameworkElement) |
| FocusDisengaged |
当用户按下游戏控制器上的 B/Back 按钮时,当焦点从控件中释放时发生。 (继承自 Control) |
| FocusEngaged |
当用户按下游戏控制器上的 A/选择按钮时,当焦点限制为控件时发生。 (继承自 Control) |
| GettingFocus |
在 UIElement 接收焦点之前发生。 此事件是同步引发的,以确保事件在冒泡时不会移动焦点。 (继承自 UIElement) |
| GotFocus |
当 UIElement 收到焦点时发生。 此事件是异步引发的,因此焦点可以在浮泡完成之前再次移动。 (继承自 UIElement) |
| Holding |
在此元素的命中测试区域发生其他未经处理的 保留 交互时发生。 (继承自 UIElement) |
| IsEnabledChanged |
在 IsEnabled 属性更改时发生。 (继承自 Control) |
| KeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
| KeyUp |
当 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
| LayoutUpdated |
当可视化树的布局发生更改时,由于布局相关的属性更改值或刷新布局的其他操作。 (继承自 FrameworkElement) |
| Loaded |
在构造并添加到对象树并准备好交互时发生 FrameworkElement 。 (继承自 FrameworkElement) |
| Loading |
在 FrameworkElement 开始加载时发生。 (继承自 FrameworkElement) |
| LosingFocus |
在 UIElement 失去焦点之前发生。 此事件是同步引发的,以确保事件在冒泡时不会移动焦点。 (继承自 UIElement) |
| LostFocus |
当 UIElement 失去焦点时发生。 此事件是异步引发的,因此焦点可以在浮泡完成之前再次移动。 (继承自 UIElement) |
| ManipulationCompleted |
在 UIElement 上的操作完成时发生。 (继承自 UIElement) |
| ManipulationDelta |
输入设备在操作过程中更改位置时发生。 (继承自 UIElement) |
| ManipulationInertiaStarting |
当输入设备在操作和惯性开始时失去与 UIElement 对象的接触时发生。 (继承自 UIElement) |
| ManipulationStarted |
当输入设备在 UIElement 上开始操作时发生。 (继承自 UIElement) |
| ManipulationStarting |
首次创建操作处理器时发生。 (继承自 UIElement) |
| NoFocusCandidateFound |
当用户尝试移动焦点(通过制表符或方向箭头)时发生,但焦点不会移动,因为没有在移动方向找到候选焦点。 (继承自 UIElement) |
| Opened |
显示选取器 CalendarView 时发生。 |
| PointerCanceled |
当使联系人异常失去联系人的指针时发生。 (继承自 UIElement) |
| PointerCaptureLost |
当此元素以前持有的指针捕获移动到另一个元素或其他地方时发生。 (继承自 UIElement) |
| PointerEntered |
当指针进入此元素的命中测试区域时发生。 (继承自 UIElement) |
| PointerExited |
当指针离开此元素的命中测试区域时发生。 (继承自 UIElement) |
| PointerMoved |
当指针在指针保留在此元素的命中测试区域中时发生。 (继承自 UIElement) |
| PointerPressed |
当指针设备在此元素中启动 Press 操作时发生。 (继承自 UIElement) |
| PointerReleased |
在此元素中释放之前启动 Press 操作的指针设备时发生。 请注意, 无法保证按下 操作的结束触发事件 |
| PointerWheelChanged |
当指针滚轮的增量值更改时发生。 (继承自 UIElement) |
| PreviewKeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
| PreviewKeyUp |
当 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
| ProcessKeyboardAccelerators |
按下 键盘快捷方式(或快捷键) 时发生。 (继承自 UIElement) |
| RightTapped |
当指针位于元素上时发生右键输入刺激时发生。 (继承自 UIElement) |
| SizeChanged |
在 FrameworkElement 上的 ActualHeight 或 ActualWidth 属性值更改时发生。 (继承自 FrameworkElement) |
| Tapped |
在此元素的命中测试区域发生其他未经处理的 Tap 交互时发生。 (继承自 UIElement) |
| Unloaded |
当此对象不再连接到主对象树时发生。 (继承自 FrameworkElement) |