Microsoft.UI.Xaml 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为 Windows UI 库(WinUI)提供常规框架 API。
类
AdaptiveTrigger |
表示基于窗口属性应用视觉状态的声明性规则。 |
Application |
表示当前应用程序及其可用服务。 |
ApplicationInitializationCallbackParams |
表示要传递自定义初始化序列的信息的对象。 (已过时) |
BindingFailedEventArgs |
为 DebugSettings.BindingFailed 事件提供事件数据。 |
BringIntoViewOptions |
表示在将元素引入视图时可以应用的选项。 |
BringIntoViewRequestedEventArgs |
提供 UIElement.BringIntoViewRequested 事件的数据。 |
BrushTransition |
提供元素画笔更改时的动画过渡行为。 目前仅限于 |
ColorPaletteResources |
表示一个专用资源字典,其中包含 XAML 元素使用的颜色资源。 |
CornerRadiusHelper |
提供用于处理 CornerRadius 值的基本实用工具方法。 C# 和 Microsoft Visual Basic 代码应改用 CornerRadius 的方法。 |
DataContextChangedEventArgs |
为 DataContextChanged 事件提供数据。 |
DataTemplate |
描述数据对象的可视结构。 对显示数据值的模板中的特定元素使用数据绑定。 |
DataTemplateKey |
表示 DataTemplate 类的资源键。 |
DebugSettings |
声明应用在调试环境中运行时应用的某些方面的行为方式 |
DependencyObject |
表示参与依赖属性系统的对象。 |
DependencyObjectCollection |
实现一个实际集合类,该类可以包含 DependencyObject 项。 |
DependencyProperty |
表示向依赖属性系统注册的依赖属性。 依赖属性支持值表达式、数据绑定、动画和属性更改通知。 有关 DependencyProperty 值如何充当依赖属性的标识符的详细信息,请参阅 依赖项属性概述。 |
DependencyPropertyChangedEventArgs |
提供 PropertyChangedCallback 实现的数据,该实现在依赖属性更改其值时调用。 此外,还提供 Control.IsEnabledChanged 事件以及使用 DependencyPropertyChangedEventHandler 委托的任何其他事件的事件数据。 |
DispatcherTimer |
提供集成到 调度程序 队列中的计时器,该队列按指定的时间间隔和指定优先级进行处理。 |
DragEventArgs |
提供拖放事件的数据。 |
DragOperationDeferral |
使你能够以异步方式使用目标应用拖放内容。 |
DragStartingEventArgs |
提供 DragStarting 事件的事件数据。 |
DragUI |
提供拖放操作开始时要拖动的数据的可视表示形式。 |
DragUIOverride |
提供拖放操作期间要拖动的数据的可视表示形式,包括来自拖放目标的反馈。 |
DropCompletedEventArgs |
为 DropCompleted 事件提供事件数据。 |
DurationHelper |
提供用于处理 持续时间 值的基本实用工具方法。 C# 和 Microsoft Visual Basic 代码应改用 持续时间 的方法。 |
EffectiveViewportChangedEventArgs | |
ElementFactoryGetArgs |
表示调用 IElementFactory的 GetElement 方法的实现时要使用的可选参数。 |
ElementFactoryRecycleArgs |
表示调用 IElementFactoryRecycleElement 方法的实现时要使用的可选参数。 |
ElementSoundPlayer |
表示 XAML 控件声音的玩家。 |
EventTrigger |
表示一个触发器,该触发器在响应事件时应用一组操作(动画情节提要)。 不常使用。 请参阅“备注”。 |
ExceptionRoutedEventArgs |
为异步操作(如 ImageFailed)作为事件引发的异常提供事件数据。 |
FrameworkElement |
为 Windows 运行时 UI 对象提供基元素类。
|
FrameworkTemplate |
创建元素的元素树。 FrameworkTemplate 是具有特定模板化行为的类的基类,包括 ControlTemplate 和 DataTemplate。 |
FrameworkView |
表示应用程序的 UI 窗口。 |
FrameworkViewSource |
创建视图,特别是 FrameworkView 实例。 这是基础结构,不需要在大多数应用方案中访问。 |
GridLengthHelper |
提供帮助程序方法来评估或设置 GridLength 值。 C# 代码应改用 GridLength 的方法。 |
LaunchActivatedEventArgs |
提供 Application.OnLaunched 事件的事件信息。 |
MediaFailedRoutedEventArgs |
为 MediaElement.MediaFailed 事件提供事件数据。 |
PointHelper |
提供用于设置点 值的 |
PropertyMetadata |
定义依赖属性的行为方面,包括它注册的条件。 有关如何将 |
PropertyPath |
实现一个数据结构,用于将属性描述为另一个属性下面的路径,或位于拥有类型下方。 属性路径用于数据绑定到对象。 |
RectHelper |
提供帮助程序方法来评估或设置 rect 值 |
ResourceDictionary |
为应用使用的 XAML 资源(如样式)定义存储库。 在 XAML 中定义资源,然后使用 {StaticResource} 标记扩展 并在 XAML 中检索它们,{ThemeResource} 标记扩展。 还可以使用代码访问资源,但这不太常见。 |
ResourceManagerRequestedEventArgs |
为 |
RoutedEvent |
表示路由事件到 Windows 运行时事件系统。 |
RoutedEventArgs |
包含与路由事件关联的状态信息和事件数据。 |
ScalarTransition |
当元素的不透明度或旋转属性发生更改时,提供动画转换行为。 |
Setter |
将值应用于 样式 或 VisualState中的属性。 |
SetterBase |
表示值 setter 的基类。 |
SetterBaseCollection | |
SizeChangedEventArgs |
提供与 FrameworkElement.SizeChanged 事件相关的数据。 |
SizeHelper | |
StateTrigger |
表示有条件地应用视觉状态的触发器。 |
StateTriggerBase |
表示状态触发器的基类。 |
Style |
包含可在类型实例之间共享的属性资源库。
|
StyleTypedPropertyAttribute |
表示应用于类定义的属性,并确定 |
TargetPropertyPath |
表示目标元素上属性的路径。 |
TemplatePartAttribute |
表示应用于类定义的特性,用于标识用于模板化的命名部件的类型。 |
TemplateVisualStateAttribute |
指定控件可以处于特定状态,并且控件的 ControlTemplate中预期 VisualState。 |
ThicknessHelper | |
TriggerAction |
用作 BeginStoryboard的基类。 不常使用。 请参阅“备注”。 |
TriggerActionCollection |
表示 BeginStoryboard 对象的集合。 |
TriggerBase |
用作 EventTrigger的基类。 不常使用。 请参阅“备注”。 |
TriggerCollection |
表示 EventTrigger 对象的集合。 |
UIElement |
|
UIElementWeakCollection |
表示对 UIElement 对象的弱引用的集合。 |
UnhandledExceptionEventArgs |
提供 UnhandledException 事件的数据。 |
Vector3Transition |
当元素的 Translation 或 Scale 属性发生更改时,提供动画转换行为。 |
VisualState |
表示 UI 元素处于特定状态时的视觉外观。 视觉状态使用 Setters 或 情节提要 在定义 |
VisualStateChangedEventArgs |
提供 CurrentStateChanging 和 CurrentStateChanged 事件的数据。 |
VisualStateGroup |
包含互斥 VisualState 对象和 VisualTransition 用于从一个状态到另一个状态的对象。 |
VisualStateManager |
管理视觉状态和控件视觉状态之间的转换逻辑。 还提供了对 |
VisualTransition |
表示控件从一个视觉状态过渡到另一个视觉状态时发生的视觉行为。 |
Window |
表示当前 应用程序的窗口。 |
WindowActivatedEventArgs |
包含由 Microsoft.UI.Xaml.Window.Activated 事件返回的窗口激活状态信息。 |
WindowEventArgs |
包含由 Window.Closed 事件返回的窗口状态信息。 |
WindowSizeChangedEventArgs |
包含由 Window.SizeChanged 事件返回的窗口大小状态信息。 |
WindowVisibilityChangedEventArgs |
包含由 Window.VisibilityChanged 事件返回的窗口的可见性状态信息。 |
XamlResourceReferenceFailedEventArgs |
为 |
XamlRoot |
表示 XAML 内容的树及其托管上下文的相关信息。 |
XamlRootChangedEventArgs |
提供 XamlRoot.Changed 事件的数据。 |
结构
CornerRadius |
描述圆角的特征,例如可应用于 边框。 |
Duration |
表示 时间线 处于活动状态的时间持续时间,或者更通常表示还支持两个特殊值的时间持续时间, |
GridLength |
表示显式支持 Star \ 大小调整和 自动 大小的控制逻辑的度量。 |
Thickness |
描述矩形周围框架的粗细。 四 |
接口
IDataTemplateExtension |
定义分阶段呈现数据模板的帮助程序方法。 |
IElementFactory |
支持创建和回收 UIElement 对象。 |
IXamlServiceProvider |
定义用于检索服务对象的机制;即为其他对象提供自定义支持的对象。 |
枚举
ApplicationHighContrastAdjustment |
定义常量,该常量指定启用高对比度主题时框架是否自动调整应用的视觉属性。 |
ApplicationRequiresPointerMode |
重要 不使用。 Windows 应用 SDK 不支持 ApplicationRequiresPointerMode。 指定非指针设备的交互体验,例如键盘或游戏控制器。 |
ApplicationTheme |
声明应用的主题首选项。 |
AutomationTextAttributesEnum |
定义用于标识Microsoft UI 自动化文本范围的文本属性的常量。 |
DispatcherShutdownMode |
定义指定应用程序如何关闭的常量。 |
DurationType | |
ElementHighContrastAdjustment |
定义常量,该常量指定启用高对比度主题时框架是否自动调整元素的视觉属性。 |
ElementSoundKind |
定义指定由 ElementSoundPlayer.Play 方法播放的声音的常量。 |
ElementSoundMode |
定义指定控件是否播放声音的首选项的常量。 |
ElementSoundPlayerState |
定义指定 XAML 控件是否播放声音的常量。 |
ElementSpatialAudioMode |
定义常量,该常量指示空间声音是打开、关闭还是自动处理。 |
ElementTheme |
指定一个 UI 主题,该主题应用于应用 UI 的各个 UIElement 部分。 |
FlowDirection |
定义指定文本和 UI 元素的内容流方向的常量。 |
FocusState |
描述元素如何获取焦点。 |
FocusVisualKind |
指定在使用键盘或游戏控制器导航时用于指示具有焦点的 UI 元素的视觉反馈。 |
FontCapitals |
描述 Typography.Capitals 附加属性的大写字母样式值。 |
FontEastAsianLanguage |
提供一种机制,用于为指定的东亚写作系统或语言选择特定于字体的字形版本。 |
FontEastAsianWidths |
提供用于选择不同宽度样式的字形的机制。 |
FontFraction |
描述 版式.分数 附加属性的分数样式值。 |
FontNumeralAlignment |
描述 Typography.NumeralAlignment attached 属性的数字对齐值。 |
FontNumeralStyle |
描述 版式.数字样式 附加属性的数字样式值。 |
FontVariants |
描述 Typography.Variants 附加属性的字体变体值。 |
GridUnitType |
描述 GridLength 对象持有的值类型。 |
HorizontalAlignment |
指示相对于父元素的分配布局槽的水平轴上应显示元素的位置。 |
LayoutCycleDebugBreakLevel |
定义常量,该常量指定当布局周期崩溃即将出现时,哪个级别的布局周期跟踪事件应触发调试器断点。 |
LayoutCycleTracingLevel |
定义常量,该常量指定是否将布局周期跟踪信息写入本机调试器和记录的详细信息级别。 |
LineStackingStrategy |
描述每行的线框确定的机制。 |
OpticalMarginAlignment |
指定在与文本容器边界对齐时,如何处理每字符版式中的侧控值。 |
TextAlignment |
指定文本是居中、左对齐还是右对齐。 |
TextLineBounds |
影响如何计算折线框高度 |
TextReadingOrder |
提供 |
TextTrimming |
描述在文本溢出其包含框边缘时如何剪裁文本。 |
TextWrapping |
指定在文本到达容器边缘时是否换行。 |
Vector3TransitionComponents |
定义常量,该常量指定要在 Vector3Transition 动画期间进行动画处理的轴。 |
VerticalAlignment |
描述子元素如何垂直定位或拉伸在父级的布局槽内。 |
Visibility |
指定元素的显示状态。 |
WindowActivationState |
指定在 窗口上引发已激活事件的原因。 |
委托
ApplicationInitializationCallback |
表示应在初始化序列期间调用的回调。 |
BindingFailedEventHandler |
表示将处理 DebugSettings.BindingFailed 事件的方法。 |
CreateDefaultValueCallback |
表示可作为 PropertyMetadata 构造函数的一部分调用的方法,以延迟依赖属性默认值的定义。 |
DependencyPropertyChangedCallback |
表示属性值更改时调用的回调,对于向 RegisterPropertyChangedCallback 技术注册的属性更改通知。 |
DependencyPropertyChangedEventHandler |
表示将在特定 DependencyObject 实现上更改 DependencyProperty 时发生的事件的方法。 |
DragEventHandler | |
EnteredBackgroundEventHandler |
Application.EnteredBackground 事件的处理程序。 |
ExceptionRoutedEventHandler |
表示将处理报告异常的某些事件的方法。 这些异常通常来自异步操作。 |
LeavingBackgroundEventHandler |
Application.LeavingBackground 事件的处理程序。 |
PropertyChangedCallback |
表示在依赖属性的有效属性值发生更改时调用的回调。 |
RoutedEventHandler |
表示将处理路由事件的方法。 |
SizeChangedEventHandler |
表示将处理 SizeChanged 事件的方法。 |
SuspendingEventHandler |
Application.Suspending 事件的处理程序。 |
UnhandledExceptionEventHandler |
表示将处理 UnhandledException 事件的方法。 |
VisualStateChangedEventHandler |
表示将处理 CurrentStateChanging 和 CurrentStateChanged 事件的方法。 |
示例
WinUI 3 库 应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 从 Microsoft Store 获取应用,或在 GitHub上获取源代码。