Microsoft.UI.Composition 命名空间

提供用户界面组合的 API。

名称 说明
AmbientLight

一种照亮每个目标视觉对象的光。

AnimationController

为 KeyFrameAnimation 提供播放控件。

AnimationPropertyInfo

表示有关可进行动画处理的属性的信息。

BackEasingFunction

表示一个缓动函数,该函数在动画开始在指示的路径中进行动画处理之前稍微收回动画的动作。

BooleanKeyFrameAnimation

面向具有一个或多个关键帧的布尔属性的基于时间的动画。

BounceEasingFunction

表示创建动画弹跳效果的缓动函数。

BounceScalarNaturalMotionAnimation

基于弹跳物理的动画,面向任何基于标量的属性。

BounceVector2NaturalMotionAnimation

基于弹跳物理的动画,面向任何基于 Vector2 的属性。

BounceVector3NaturalMotionAnimation

基于弹跳物理的动画,面向任何基于 Vector3 的属性。

CircleEasingFunction

表示一个缓动函数,该函数创建一个动画,该动画使用循环函数加速和/或减速。

ColorKeyFrameAnimation

以一个或多个颜色关键帧为目标的 Color 属性的基于时间的动画。

ColorKeyFrameAnimation 类是 KeyFrameAnimation支持的类型之一,用于在 SpriteVisual 上对 Brush 属性的 Color 属性进行动画处理。 使用 ColorKeyFrameAnimation 时,请使用Windows。Ui。关键帧值的颜色对象。 利用 InterpolationColorSpace 属性定义系统为动画内插的哪些颜色空间。

CompositionAnimation

表示基动画类。

CompositionAnimationGroup

定义一组动画。

CompositionAnimationGroup 提供了一种将 CompositionAnimation分组到列表中的方法,该列表将在在 CompositionObject 上调用 StartAnimationGroup 时同时启动。 CompositionAnimationGroup 中的所有 CompositionAnimation 都需要为动画本身中的 Target 属性赋值。 CompositionAnimationGroup 还可以与 ImplicitAnimationCollection 相关联,作为作为触发器结果执行的动画。

CompositionApiInformation

表示有关合成 API 的信息。

CompositionBackdropBrush

将效果(或效果链)应用于 SpriteVisual 后面的区域的画笔。

CompositionBatchCompletedEventArgs

CompositionCommitBatch.CompletedCompositionScopedBatch.Completed 事件的参数。

CompositionBrush

用于绘制 SpriteVisual 的画笔的基类。

CompositionCapabilities

提供检查系统硬件功能的功能,以便可以相应地缩放视觉层效果。 这样,就可以确保应用程序使用渲染密集型操作,以匹配设备的功能,从而提供最佳性能和愉快的视觉效果。

CompositionClip

剪裁对象(如 InsetClip)的基类。

CompositionColorBrush

用纯色绘制 SpriteVisual

CompositionColorGradientStop

描述渐变中过渡点的位置和颜色。

CompositionColorGradientStopCollection

表示可以通过索引单独访问的 CompositionColorGradientStop 对象的集合。

CompositionCommitBatch

一组活动动画或效果。

CompositionContainerShape

表示 CompositionShapes 的容器,用于对共享 2D 转换的项进行分组。

CompositionDrawingSurface

用于与 Direct2D 或 Direct3D 互操作的绘图图面。

CompositionEasingFunction

要与 KeyFrameAnimations 一起使用的内插器函数的基类。

CompositionEasingFunction 类是用于 KeyFrameAnimation 的缓动函数的基类。 缓动函数用于描述系统如何在两个不同的关键帧之间内插。 目前,有三个受支持的缓动函数: 线性立方贝塞尔步骤

CompositionEffectBrush

使用筛选器效果的输出绘制 SpriteVisual。 筛选器效果说明是使用 CompositionEffectFactory 类定义的。

CompositionEffectFactory

在Microsoft中创建包含 Win2D 效果说明格式的合成对象。Graphics.Canvas.Effects 命名空间 (Windows 应用 SDK (WinUI 3) / UWP (WinUI 2))。

注释

不支持的效果在 Win2D API 参考 中标记为效果命名空间中的 [NoComposition]。

CompositionEffectSourceParameter

用于声明任意名称(字符串)以与 CompositionBrush(“效果源”)相关联。 调用 CompositionEffectBrushSetSourceParameter 方法时,将发生给定名称和效果源的关联。

CompositionEllipseGeometry

表示具有指定中心和半径的省略号。

CompositionEngine

提供用于选择和检索合成引擎的静态方法。 这是一项不稳定的受限访问功能(LAF),它允许应用选择使用 OS 作为合成 API 的引擎,而不是默认进程内引擎。

CompositionGeometricClip

表示剪裁视觉对象的一部分的形状。 视觉对象的可见部分是由 CompositionGeometry 定义的形状。 将剪裁几何图形外部的视觉对象部分。

CompositionGeometry

表示组合几何图形的基类。

CompositionGradientBrush

表示描述渐变的画笔,该画笔由渐变停止点组成。

CompositionGradientBrush 仅支持 Rgb 和 RgbLinear CompositionColorSpace。

CompositionGraphicsDevice

用于在撰写器会话上为给定的 DirectX 设备创建所有硬件绑定资源。 CompositionGraphicsDevice 包含用于执行 GPU 操作的 DirectX 设备。 开发人员可以从合成器顶级对象获取图形设备。

CompositionLight

可面向 UI 场景的光源的基类。

CompositionLight.Targets 属性确定哪些视觉对象已亮起。

CompositionLinearGradientBrush

表示绘制具有线性渐变的区域的画笔。

CompositionLineGeometry

表示两个点之间的直线。

CompositionMaskBrush

使用应用于它的不透明度掩码的 CompositionBrush 绘制 SpriteVisual。 不透明度掩码的来源可以是 CompositionColorBrush、CompositionLinearGradientBrush、CompositionSurfaceBrush、CompositionEffectBrush 或 CompositionNineGridBrush 类型的 CompositionBrush。 不透明度掩码必须指定为 CompositionSurfaceBrush。

CompositionMipmapSurface

表示 mipmap 纹理的绘图图面。

CompositionNineGridBrush

将 Nine-Grid 拉伸应用到源画笔的内容后,使用 CompositionBrush 绘制 SpriteVisual 。 9 网格拉伸的源可以由 CompositionColorBrush、CompositionSurfaceBrush 或 CompositionEffectBrush 类型的任何 CompositionBrush 提供。

CompositionNotificationDeferral

表示应用可用于异步响应合成通知的延迟。

CompositionObject

表示可视化树结构中的节点的合成 API 的基类。

合成对象是合成 API 使用和构建的所有其他功能的可视化树结构。 API 允许开发人员定义和创建一个或多个可视化对象,每个 对象 表示可视化树中的单个节点。

CompositionPath

表示一系列连接的线条和曲线。

CompositionPathGeometry

表示一系列连接的线条和曲线。

CompositionProjectedShadow

表示使用光线、投射阴影的视觉对象和接收阴影的视觉对象之间的关系计算的基于场景的阴影,以便在每个接收器上以不同的方式绘制阴影。

CompositionProjectedShadowCaster

表示一个对象,该对象将投影阴影投射。

CompositionProjectedShadowCasterCollection

表示 CompositionProjectedShadowCaster 对象的集合。

CompositionProjectedShadowReceiver

表示一个对象,该对象可对对象进行投影阴影投射。

CompositionProjectedShadowReceiverUnorderedCollection

表示 CompositionProjectedShadowReceiver 对象的无序集合。

CompositionPropertySet

将值存储为键值对。

CompositionRadialGradientBrush

表示绘制具有径向渐变的区域的画笔。

CompositionRectangleGeometry

表示指定大小的矩形形状。

CompositionRoundedRectangleGeometry

表示具有圆角的指定大小的矩形形状。

CompositionScopedBatch

显式创建的一组活动动画或效果。

CompositionShadow

可应用于 SpriteVisual 的阴影的基类。

CompositionShape

表示基形状类。

CompositionShapeCollection

表示可由索引单独访问的 CompositionShape 对象的集合。

CompositionSpriteShape

绘制笔划和填充 CompositionGeometry 的 CompositionShape

CompositionStrokeDashArray

表示一个值集合,该值指示用于轮廓形状的短划线和间隙的图案。

CompositionSurfaceBrush

用 ICompositionSurface 中的像素绘制 SpriteVisual

CompositionTransform

为组合对象提供通用转换支持。

CompositionViewBox

表示将形状可视化树坐标映射到视觉对象的容器。

CompositionVirtualDrawingSurface

表示可与可视化树中组合的视觉对象关联的稀疏分配的位图。

CompositionVisualSurface

将可视化树表示为 ICompositionSurface,可用于使用 CompositionBrush 绘制视觉对象。

Compositor

管理应用程序与系统组合器进程之间的会话。

Compositor 类为应用程序创建 Compositor 的实例,该实例可用作Microsoft中各种类型的工厂。Ui。跨越视觉层、效果系统和动画系统的合成命名空间。 Compositor 类还负责管理由工厂创建的对象的生命周期。

ContainerVisual

可视化树中可以具有子级的节点。

CubicBezierEasingFunction

表示用于在动画关键帧之间内插的立方贝塞尔函数。

立方-贝塞尔函数是与 KeyFrameAnimation一起使用的更常见的缓动函数之一,用于描述可缩放的平滑曲线。 立方-贝塞尔函数由 Vector2 类型的两个“控制点”定义曲线的形状定义。 使用时,动画属性将根据定义的曲线在两个关键帧之间更改。

DistantLight

一个无限大的遥远的光源,以单个方向发出光。 例如,遥远的光可用于表示阳光。

DropShadow

由 SpriteVisualLayerVisual 投射的投影。

ElasticEasingFunction

表示缓动函数,该函数创建一个动画,该动画类似于一个春天来回振荡,直到它到达休息为止。

ExponentialEasingFunction

表示一个缓动函数,该函数创建使用指数公式加速和/或减速的动画。

ExpressionAnimation

使用数学公式计算每个帧的动画属性的值的合成动画。

ImplicitAnimationCollection

满足条件时触发的动画集合。

InitialValueExpressionCollection

一个值集合,用于指定动画的开始位置。

InsetClip

表示剪裁视觉对象的一部分的矩形。 矩形内视觉对象的部分可见;将剪裁矩形外部视觉对象的部分。

KeyFrameAnimation

具有一个或多个关键帧的基于时间的动画。 这些帧是标记,允许开发人员在动画属性的特定时间指定值。 通过指定关键帧之间的内插方式,可以进一步自定义关键帧动画。

LayerVisual

一个 ContainerVisual,其子级平展为单个层。

LinearEasingFunction

表示用于在动画关键帧之间内插的线性函数。

NaturalMotionAnimation

表示一个基于物理的动画,该动画使用强制来动态移动内容。

PathKeyFrameAnimation

表示具有一个或多个关键帧的基于时间的动画,其中每个关键帧值由 CompositionPath 表示。 缓动指定路径之间的交错。

PointLight

一种光点源,在所有方向上都产生光线。

PowerEasingFunction

表示一个缓动函数,该函数创建一个动画,该动画使用公式 ft) = tp 加速和/或减速,其中 p 等于 Power 属性。

QuaternionKeyFrameAnimation

基于时间的动画,面向具有一个或多个关键帧的 Orientation 属性。

QuaternionKeyFrameAnimation 类是一种受支持的 KeyFrameAnimation类型,用于对视觉对象上的 Orientation 属性进行动画处理。 四元数是一种有用的有时更简单的旋转方式 - 四元数采用角度之间的最短路径,并避免像 Gimbal Lock 这样的问题,即旋转角度/轴和旋转矩阵。 四元数由两个组成部分组成:标量和矢量部分。

RectangleClip

表示具有可选圆角的矩形,用于剪辑视觉对象的一部分。 矩形内视觉对象的部分可见;将剪裁矩形外部视觉对象的部分。

RedirectVisual

表示从另一个视觉对象获取其内容的视觉对象。

RenderingDeviceReplacedEventArgs

RenderingDeviceReplaced 事件的参数。

ScalarKeyFrameAnimation

基于时间的动画,面向具有一个或多个关键帧的任何基于标量的属性。

ScalarNaturalMotionAnimation

用于定位标量属性的基本 Scalar NaturalMotionAnimation。

ShapeVisual

表示作为 CompositionShape 根目录的可视化树节点。

SineEasingFunction

表示一个缓动函数,该函数创建使用正弦公式加速和/或减速的动画。

SpotLight

一种光线源,可投射光的内锥体和外锥体。 例如,手电筒。

SpringScalarNaturalMotionAnimation

一个基于春季物理的动画,面向任何基于标量的属性。

SpringVector2NaturalMotionAnimation

基于春季物理的动画,面向任何基于 Vector2 的属性。

SpringVector3NaturalMotionAnimation

基于 Spring 物理的动画,面向任何基于 Vector3 的属性。

SpriteVisual

承载 CompositionBrush 类型的 2D 装箱内容。 画笔中未由像素覆盖的视觉对象的任何部分都呈现为透明像素。 CompositionBrush 可以是 CompositionBackdropBrushCompositionColorBrush、CompositionSurfaceBrushCompositionEffectBrush

StepEasingFunction

用于在动画关键帧之间内插的步骤函数。

按增量推进动画,例如可以定义的步骤。 可以自定义初始步骤和最终步骤的行为。

Vector2KeyFrameAnimation

基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector2 的属性。

Vector2NaturalMotionAnimation

用于面向 Vector2 属性的基本 Vector2 NaturalMotionAnimation。

Vector3KeyFrameAnimation

基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector3 的属性。

Vector3NaturalMotionAnimation

用于面向 Vector3 属性的基本 Vector3 NaturalMotionAnimation。

Vector4KeyFrameAnimation

基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector4 的属性。

Visual

视觉对象层次结构中的基视觉对象。

VisualCollection

表示视觉实例的集合。

VisualUnorderedCollection

视觉对象的无序集合。

接口

名称 说明
IAnimationObject

表示具有可由动画引用的属性的对象。

ICompositionAnimationBase

合成动画的基类。

ICompositionSupportsSystemBackdrop

提供一个属性,用于将 CompositionBrush 用作系统背景。 具有给定 CompositionBrushSpriteVisual 将放置在实现对象的子树的后面。

ICompositionSurface

表示可用于绘制边界的 SpriteVisual图面的内容。

ICompositionSurfaceFacade

表示可用于真实合成图面的合成图面的占位符。

IVisualElement

标记一个对象以向系统指示它可以解析为合成 视觉对象

IVisualElement2

提供检索对象的基础 视觉对象的方法。

枚举

名称 说明
AnimationControllerProgressBehavior

定义指定 AnimationController.Progress 值的确定方式的常量。

AnimationDelayBehavior

指定动画延迟行为。

AnimationDirection

指定动画的播放方向。

AnimationIterationBehavior

指定动画是否应循环。

AnimationPropertyAccessMode

定义指定如何访问动画属性的常量。

AnimationStopBehavior

指定动画停止时的行为。

CompositionBackfaceVisibility

指定在 3D 转换期间视觉对象的背面是否可见。

CompositionBatchTypes

CompositionCommitBatchCompositionScopedBatch 的批处理类型。

CompositionBitmapInterpolationMode

指定在 ICompositionSurface 中不形成一对一映射到屏幕上像素的一对一映射时用于从 ICompositionSurface 插入像素的算法。

CompositionBorderMode

控制视觉边框边缘的别名行为。

CompositionColorSpace

指定在 ColorKeyFrameAnimation 中插入颜色值的颜色空间。

CompositionCompositeMode

确定非不透明视觉对象的内容如何与视觉对象背后的背景内容混合。

CompositionDropShadowSourcePolicy

指定阴影的掩码策略。

CompositionEasingFunctionMode

定义常量,该常量指定与缓动函数内插关联的动画的方式。

CompositionEffectFactoryLoadStatus

效果说明的着色器的异步编译状态。

CompositionEngineType

定义用于合成 API 的合成引擎的类型。

CompositionGetValueStatus

指示尝试检索键值对的值的结果。

CompositionGradientExtendMode

定义指定如何在画笔的渐变向量或空间之外绘制渐变的常量。

CompositionMappingMode

定义常量,该常量指定渐变画笔的位置坐标(StartPoint,EndPoint)是绝对的还是相对于输出区域的。

CompositionProjectedShadowDrawOrder

提供用户界面组合的 API。

CompositionStretch

指定将内容从源映射到目标空间时如何缩放。

CompositionStrokeCap

定义在线条或线段末尾指定形状的常量。

CompositionStrokeLineJoin

定义常量,该常量指定用于联接两行或段的形状。

注解

Windows。Ui。合成概述、示例和已知问题

物品 说明
Windows。UI。合成概述 API 概述和体系结构
Windows。Ui。合成示例 官方 Github 中的 API 示例
已知问题和最新信息 MSDN 论坛中 API 的最新更新

另请参阅