Microsoft.UI.Composition 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供用户界面组合的 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.Completed 或 CompositionScopedBatch.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(“效果源”)相关联。 调用 CompositionEffectBrush 的 SetSourceParameter 方法时,将发生给定名称和效果源的关联。 |
| 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 | |
| CompositionStrokeDashArray |
表示一个值集合,该值指示用于轮廓形状的短划线和间隙的图案。 |
| CompositionSurfaceBrush |
用 ICompositionSurface 中的像素绘制 SpriteVisual 。 |
| CompositionTransform |
为组合对象提供通用转换支持。 |
| CompositionViewBox |
表示将形状可视化树坐标映射到视觉对象的容器。 |
| CompositionVirtualDrawingSurface |
表示可与可视化树中组合的视觉对象关联的稀疏分配的位图。 |
| CompositionVisualSurface |
将可视化树表示为 ICompositionSurface,可用于使用 CompositionBrush 绘制视觉对象。 |
| Compositor |
管理应用程序与系统组合器进程之间的会话。 Compositor 类为应用程序创建 Compositor 的实例,该实例可用作Microsoft中各种类型的工厂。Ui。跨越视觉层、效果系统和动画系统的合成命名空间。 Compositor 类还负责管理由工厂创建的对象的生命周期。 |
| ContainerVisual |
可视化树中可以具有子级的节点。 |
| CubicBezierEasingFunction |
表示用于在动画关键帧之间内插的立方贝塞尔函数。 立方-贝塞尔函数是与 KeyFrameAnimation一起使用的更常见的缓动函数之一,用于描述可缩放的平滑曲线。 立方-贝塞尔函数由 Vector2 类型的两个“控制点”定义曲线的形状定义。 使用时,动画属性将根据定义的曲线在两个关键帧之间更改。 |
| DistantLight |
一个无限大的遥远的光源,以单个方向发出光。 例如,遥远的光可用于表示阳光。 |
| DropShadow |
由 SpriteVisual 或 LayerVisual 投射的投影。 |
| ElasticEasingFunction |
表示缓动函数,该函数创建一个动画,该动画类似于一个春天来回振荡,直到它到达休息为止。 |
| ExponentialEasingFunction |
表示一个缓动函数,该函数创建使用指数公式加速和/或减速的动画。 |
| ExpressionAnimation |
使用数学公式计算每个帧的动画属性的值的合成动画。 |
| ImplicitAnimationCollection |
满足条件时触发的动画集合。 |
| InitialValueExpressionCollection |
一个值集合,用于指定动画的开始位置。 |
| InsetClip |
表示剪裁视觉对象的一部分的矩形。 矩形内视觉对象的部分可见;将剪裁矩形外部视觉对象的部分。 |
| KeyFrameAnimation |
具有一个或多个关键帧的基于时间的动画。 这些帧是标记,允许开发人员在动画属性的特定时间指定值。 通过指定关键帧之间的内插方式,可以进一步自定义关键帧动画。 |
| LayerVisual |
一个 ContainerVisual,其子级平展为单个层。 |
| LinearEasingFunction |
表示用于在动画关键帧之间内插的线性函数。 |
| NaturalMotionAnimation |
表示一个基于物理的动画,该动画使用强制来动态移动内容。 |
| PathKeyFrameAnimation |
表示具有一个或多个关键帧的基于时间的动画,其中每个关键帧值由 CompositionPath 表示。 缓动指定路径之间的交错。 |
| PointLight |
一种光点源,在所有方向上都产生光线。 |
| PowerEasingFunction |
表示一个缓动函数,该函数创建一个动画,该动画使用公式 f(t) = tp 加速和/或减速,其中 p 等于 |
| 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 可以是 CompositionBackdropBrush、CompositionColorBrush、CompositionSurfaceBrush 或 CompositionEffectBrush。 |
| StepEasingFunction |
用于在动画关键帧之间内插的步骤函数。 按增量推进动画,例如可以定义的步骤。 可以自定义初始步骤和最终步骤的行为。 |
| Vector2KeyFrameAnimation |
基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector2 的属性。 |
| Vector2NaturalMotionAnimation |
用于面向 Vector2 属性的基本 Vector2 NaturalMotionAnimation。 |
| Vector3KeyFrameAnimation |
基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector3 的属性。 |
| Vector3NaturalMotionAnimation |
用于面向 Vector3 属性的基本 Vector3 NaturalMotionAnimation。 |
| Vector4KeyFrameAnimation |
基于时间的动画,面向具有一个或多个关键帧的任何基于 Vector4 的属性。 |
| Visual |
视觉对象层次结构中的基视觉对象。 |
| VisualCollection |
表示视觉实例的集合。 |
| VisualUnorderedCollection |
视觉对象的无序集合。 |
接口
| 名称 | 说明 |
|---|---|
| IAnimationObject |
表示具有可由动画引用的属性的对象。 |
| ICompositionAnimationBase |
合成动画的基类。 |
| ICompositionSupportsSystemBackdrop |
提供一个属性,用于将 CompositionBrush 用作系统背景。 具有给定 CompositionBrush 的 SpriteVisual 将放置在实现对象的子树的后面。 |
| ICompositionSurface |
表示可用于绘制边界的 |
| ICompositionSurfaceFacade |
表示可用于真实合成图面的合成图面的占位符。 |
| IVisualElement |
标记一个对象以向系统指示它可以解析为合成 视觉对象 |
| IVisualElement2 |
提供检索对象的基础 视觉对象的方法。 |
枚举
注解
Windows。Ui。合成概述、示例和已知问题
| 物品 | 说明 |
|---|---|
| Windows。UI。合成概述 | API 概述和体系结构 |
| Windows。Ui。合成示例 | 官方 Github 中的 API 示例 |
| 已知问题和最新信息 | MSDN 论坛中 API 的最新更新 |