Microsoft.UI.Xaml 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为 Windows UI 库提供常规框架 API (WinUI) 。
类
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 |
提供集成到 Dispatcher 队列中的计时器,该队列按指定的时间间隔和指定的优先级进行处理。 |
DragEventArgs |
提供拖放事件的数据。 |
DragOperationDeferral |
使你能够以异步方式将内容与目标应用一起拖放。 |
DragStartingEventArgs |
提供 DragStarting 事件的事件数据。 |
DragUI |
提供拖放操作开始时拖动的数据的可视表示形式。 |
DragUIOverride |
提供拖放操作期间要拖动的数据的可视表示形式,包括来自放置目标的反馈。 |
DropCompletedEventArgs |
提供 DropCompleted 事件的事件数据。 |
DurationHelper |
提供用于处理 Duration 值的基本实用工具方法。 C# 和 Microsoft Visual Basic 代码应改用 Duration 方法。 |
EffectiveViewportChangedEventArgs | |
ElementFactoryGetArgs |
表示在调用 IElementFactory 的 GetElement 方法的实现时要使用的可选参数。 |
ElementFactoryRecycleArgs |
表示在调用 IElementFactory 的 RecycleElement 方法的实现时要使用的可选参数。 |
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 | |
ResourceDictionary |
定义应用使用的 XAML 资源(例如样式)的存储库。 在 XAML 中定义资源,然后可以使用 {StaticResource} 标记扩展和 {ThemeResource} 标记扩展在 XAML 中检索它们。 还可以使用代码访问资源,但这并不常见。 |
ResourceManagerRequestedEventArgs |
提供事件的事件 |
RoutedEvent |
表示路由到Windows 运行时事件系统的事件。 |
RoutedEventArgs |
包含与路由事件相关联的状态信息和事件数据。 |
ScalarTransition |
提供元素的不透明度或旋转属性更改时的动画转换行为。 |
Setter |
将值应用于 Style 或 VisualState 中的属性。 |
SetterBase |
表示值 Setter 的基类。 |
SetterBaseCollection |
表示继承自 SetterBase 的 对象的集合。 |
SizeChangedEventArgs |
提供与 FrameworkElement.SizeChanged 事件相关的数据。 |
SizeHelper | |
StateTrigger |
表示有条件地应用视觉状态的触发器。 |
StateTriggerBase |
表示状态触发器的基类。 |
Style |
包含可在类型实例之间共享的属性资源库。
|
StyleTypedPropertyAttribute |
表示应用于类定义的属性,并确定 Style 类型的属性的 TargetType。 |
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 或 Storyboard 在定义 的页面或控件模板 |
VisualStateChangedEventArgs |
提供 CurrentStateChanging 和 CurrentStateChanged 事件的数据。 |
VisualStateGroup |
包含互斥 的 VisualState 对象和用于从一个状态转到另一个状态的 VisualTransition 对象。 |
VisualStateManager |
管理控件的视觉状态和在视觉状态之间转换的逻辑。 还提供对 |
VisualTransition |
表示控件从一种视觉状态转换为另一种视觉状态时发生的视觉行为。 |
Window |
表示当前 应用程序的窗口。 |
WindowActivatedEventArgs |
包含事件返回 Window.Activated 的窗口的激活状态信息。 |
WindowEventArgs |
包含 Window.Closed 事件返回的窗口状态信息。 |
WindowSizeChangedEventArgs |
包含 Window.SizeChanged 事件返回的窗口的大小状态信息。 |
WindowVisibilityChangedEventArgs |
包含 Window.VisibilityChanged 事件返回的窗口的可见性 状态信息。 |
XamlResourceReferenceFailedEventArgs |
提供事件的事件 |
XamlRoot |
表示 XAML 内容树,以及有关托管它的上下文的信息。 |
XamlRootChangedEventArgs |
提供 XamlRoot.Changed 事件的数据。 |
结构
CornerRadius |
描述圆角的特征,例如可以应用于 边框。 |
Duration |
表示 时间线 处于活动状态的持续时间,或者更通常表示也支持两个特殊值 |
GridLength |
表示显式支持 Star (*) 大小调整和 自动 调整大小的控制逻辑的度量。 |
Thickness |
描述矩形边框的粗细。 四个 Double 值分别描述矩形的 左、 上、 右和 下 边。 |
接口
IDataTemplateExtension |
定义用于分阶段呈现数据模板的帮助程序方法。 |
IElementFactory |
支持创建和回收 UIElement 对象。 |
IXamlServiceProvider |
定义用于检索服务对象的机制;也即,向其他对象提供自定义支持的对象。 |
枚举
ApplicationHighContrastAdjustment |
定义常量,这些常量指定在启用高对比度主题时框架是否自动调整应用的视觉属性。 |
ApplicationRequiresPointerMode |
重要 请勿使用。 Windows 应用 SDK不支持 ApplicationRequiresPointerMode。 指定非指针设备(如键盘或游戏控制器)的交互体验。 |
ApplicationTheme |
声明应用的主题首选项。 |
AutomationTextAttributesEnum |
定义标识 Microsoft UI 自动化文本范围的文本属性的常量。 |
DispatcherShutdownMode |
定义指定应用程序如何关闭的常量。 |
DurationType |
声明 Duration 是具有特殊值 Automatic 或 Forever,还是在其 |
ElementHighContrastAdjustment |
定义常量,这些常量指定在启用高对比度主题时框架是否自动调整元素的视觉属性。 |
ElementSoundKind |
定义指定 ElementSoundPlayer.Play 方法播放的声音的常量。 |
ElementSoundMode |
定义常量,这些常量指定控件是否播放声音的首选项。 |
ElementSoundPlayerState |
定义指定 XAML 控件是否播放声音的常量。 |
ElementSpatialAudioMode |
定义常量,这些常量指示空间声音是自动打开、关闭还是自动处理。 |
ElementTheme |
指定应用于应用 UI 的各个 UIElement 部分的 UI 主题。 |
FlowDirection |
定义指定文本和 UI 元素的内容流方向的常量。 |
FocusState |
描述元素如何获得焦点。 |
FocusVisualKind |
指定使用键盘或游戏控制器导航时用于指示具有焦点的 UI 元素的视觉反馈。 |
FontCapitals |
描述 Typography.Capitals 附加属性的大写字母样式值。 |
FontEastAsianLanguage |
提供一种机制,用于为指定的东亚书写系统或语言选择特定于字体的字形版本。 |
FontEastAsianWidths |
提供用于选择不同宽度样式的字形的机制。 |
FontFraction |
描述 Typography.Fraction 附加属性的分数样式值。 |
FontNumeralAlignment |
描述 Typography.NumeralAlignment 附加属性的数字对齐值。 |
FontNumeralStyle |
描述 Typography.NumeralStyle 附加属性的数字样式值。 |
FontVariants |
描述 Typography.Variants 附加属性的字体变体值。 |
GridUnitType |
描述 GridLength 对象持有的值类型。 |
HorizontalAlignment |
指示应在哪里将元素显示在与父元素的已分配布局槽相对的水平轴上。 |
LayoutCycleDebugBreakLevel |
定义常量,这些常量指定当布局周期崩溃迫在眉睫时,哪个级别的布局周期跟踪事件应触发调试器断点。 |
LayoutCycleTracingLevel |
定义常量,这些常量指定是否将布局周期跟踪信息写入本机调试器以及所记录的详细信息级别。 |
LineStackingStrategy |
描述确定每行的线条框的机制。 |
OpticalMarginAlignment |
指定在与文本容器边界对齐时如何处理每字符版式中的侧边承载值。 |
TextAlignment |
指定文本是居中、左对齐还是右对齐。 |
TextLineBounds |
影响线框高度的计算方式 |
TextReadingOrder |
为属性提供一个值 |
TextTrimming |
描述当文本溢出其包含框的边缘时如何修整文本。 |
TextWrapping |
指定文本到达其容器边缘时是否换行。 |
Vector3TransitionComponents |
定义常量,这些常量指定要在 Vector3Transition 动画期间进行动画处理的轴。 |
VerticalAlignment |
描述如何在父级布局槽内垂直地定位或拉伸子元素。 |
Visibility |
指定元素的显示状态。 |
WindowActivationState |
指定在 Window 上引发 Activated 事件的原因。 |
委托
示例
WinUI 3 库应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用,或在 GitHub 上获取源代码。