Compositor 类

定义

命名空间:

Windows.UI.Composition

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

Compositor 类为应用程序创建 Compositor 的实例，该应用程序可用作跨视觉层、效果系统和动画系统的 Windows.UI.Composition 命名空间中各种类型的工厂。 Compositor 类还用于管理从工厂创建的对象的生存期。

public ref class Compositor sealed : IClosable

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Compositor final : IClosable

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public sealed class Compositor : System.IDisposable

Public NotInheritable Class Compositor
Implements IDisposable

继承

Object Platform::Object IInspectable Compositor

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

Compositor 隐式同步对关联视觉对象所做的更改，以确保以事务方式应用这些更改。

有关详细信息，请参阅 合成 UI 概述 和 合成可视化树概述 。

必须在具有 CoreDispatcher 的线程中创建 Compositor 的新实例。

版本历史记录

Windows 版本	SDK 版本	增值
1607	14393	CreateAmbientLight
1607	14393	CreateAnimationGroup
1607	14393	CreateBackdropBrush
1607	14393	CreateDistantLight
1607	14393	CreateDropShadow
1607	14393	CreateImplicitAnimationCollection
1607	14393	CreateLayerVisual
1607	14393	CreateMaskBrush
1607	14393	CreateNineGridBrush
1607	14393	CreatePointLight
1607	14393	CreateSpotLight
1607	14393	CreateStepEasingFunction
1607	14393	CreateStepEasingFunction (Int32)
1703	15063	CreateHostBackdropBrush
1709	16299	CreateColorGradientStop
1709	16299	CreateColorGradientStop (Single，Color)
1709	16299	CreateLinearGradientBrush
1709	16299	CreateSpringScalarAnimation
1709	16299	CreateSpringVector2Animation
1709	16299	CreateSpringVector3Animation
1803	17134	注释
1803	17134	CreateBounceScalarAnimation
1803	17134	CreateBounceVector2Animation
1803	17134	CreateBounceVector3Animation
1803	17134	CreateContainerShape
1803	17134	CreateEllipseGeometry
1803	17134	CreateLineGeometry
1803	17134	CreatePathGeometry
1803	17134	CreatePathGeometry (CompositionPath)
1803	17134	CreatePathKeyFrameAnimation
1803	17134	CreateRectangleGeometry
1803	17134	CreateRoundedRectangleGeometry
1803	17134	CreateShapeVisual
1803	17134	CreateSpriteShape
1803	17134	CreateSpriteShape (CompositionGeometry)
1803	17134	CreateViewBox
1803	17134	GlobalPlaybackRate
1803	17134	MaxGlobalPlaybackRate
1803	17134	MinGlobalPlaybackRate
1803	17134	RequestCommitAsync
1809	17763	CreateBooleanKeyFrameAnimation
1809	17763	CreateGeometricClip
1809	17763	CreateGeometricClip (CompositionGeometry)
1809	17763	CreateRedirectVisual
1809	17763	CreateRedirectVisual (Visual)
1903	18362	CreateProjectedShadow
1903	18362	CreateProjectedShadowCaster
1903	18362	CreateProjectedShadowReceiver
1903	18362	CreateRadialGradientBrush
1903	18362	CreateVisualSurface

构造函数

Compositor()

创建 Compositor 的实例。

属性

Comment	获取或设置要与 Compositor 关联的字符串。
DispatcherQueue	获取此合成程序的调度程序队列。
GlobalPlaybackRate	获取或设置此合成器创建的所有关键帧动画的动画播放速率。
MaxGlobalPlaybackRate	获取此合成器创建的所有关键帧动画允许的最大播放速率。
MinGlobalPlaybackRate	获取此合成器创建的所有关键帧动画允许的最小播放速率。

方法

Close()	关闭 Compositor 对象并释放系统资源。
CreateAmbientLight()	创建 AmbientLight 的实例。
CreateAnimationController()	创建 AnimationController 的实例。
CreateAnimationGroup()	创建 CompositionAnimationGroup 的实例。
CreateAnimationPropertyInfo()	创建 AnimationPropertyInfo 的实例。
CreateBackdropBrush()	创建 CompositionBackdropBrush 的实例。
CreateBooleanKeyFrameAnimation()	创建 BooleanKeyFrameAnimation 的实例。
CreateBounceScalarAnimation()	创建 BounceScalarNaturalMotionAnimation 的实例。
CreateBounceVector2Animation()	创建 BounceVector2NaturalMotionAnimation 的实例。
CreateBounceVector3Animation()	创建 BounceVector3NaturalMotionAnimation 的实例。
CreateColorBrush()	创建 CompositionColorBrush 的实例。
CreateColorBrush(Color)	使用指定颜色创建 CompositionColorBrush 的实例。
CreateColorGradientStop()	创建 CompositionColorGradientStop 的实例。
CreateColorGradientStop(Single, Color)	创建具有指定偏移量和颜色的 CompositionColorGradientStop 实例。
CreateColorKeyFrameAnimation()	创建 ColorKeyFrameAnimation 的实例。
CreateContainerShape()	创建 CompositionContainerShape 的实例。
CreateContainerVisual()	创建 ContainerVisual 的实例。
CreateCubicBezierEasingFunction(Vector2, Vector2)	创建 CubicBezierEasingFunction 的实例。
CreateDistantLight()	创建 DistantLight 的实例。
CreateDropShadow()	创建 DropShadow 的实例。
CreateEffectFactory(IGraphicsEffect)	创建 CompositionEffectFactory 的实例。
CreateEffectFactory(IGraphicsEffect, IIterable<String>)	创建 CompositionEffectFactory 的实例，指定应可进行动画处理的效果参数。
CreateEllipseGeometry()	创建 CompositionEllipseGeometry 的实例。
CreateExpressionAnimation()	创建 ExpressionAnimation 的实例。
CreateExpressionAnimation(String)	创建 ExpressionAnimation 的实例。
CreateGeometricClip()	创建 CompositionGeometricClip 的实例。
CreateGeometricClip(CompositionGeometry)	使用指定的几何图形创建 CompositionGeometricClip 的实例。
CreateHostBackdropBrush()	在绘制窗口之前，创建 CompositionBackdropBrush 的实例，该实例从视觉对象后面的区域采样。
CreateImplicitAnimationCollection()	创建 ImplicitAnimationCollection 的实例。
CreateInsetClip()	创建 InsetClip 的实例。
CreateInsetClip(Single, Single, Single, Single)	创建 InsetClip 的实例。
CreateLayerVisual()	创建 LayerVisual 的实例。
CreateLinearEasingFunction()	创建 LinearEasingFunction 的实例。
CreateLinearGradientBrush()	创建 CompositionLinearGradientBrush 的实例。
CreateLineGeometry()	创建 CompositionLineGeometry 的实例。
CreateMaskBrush()	创建 CompositionMaskBrush 的实例。
CreateNineGridBrush()	创建 CompositionNineGridBrush 的实例。
CreatePathGeometry()	创建 CompositionPathGeometry 的实例。
CreatePathGeometry(CompositionPath)	使用指定路径创建 CompositionPathGeometry 的实例。
CreatePathKeyFrameAnimation()	创建 PathKeyFrameAnimation 的实例。
CreatePointLight()	创建 PointLight 的实例。
CreateProjectedShadow()	创建 CompositionProjectedShadow 的实例。
CreateProjectedShadowCaster()	创建 CompositionProjectedShadowCaster 的实例。
CreateProjectedShadowReceiver()	创建 CompositionProjectedShadowReceiver 的实例。
CreatePropertySet()	创建 CompositionPropertySet 的实例。
CreateQuaternionKeyFrameAnimation()	创建 QuaternionKeyFrameAnimation 的实例。
CreateRadialGradientBrush()	创建 CompositionRadialGradientBrush 的实例。
CreateRectangleClip()	使用默认值创建 RectangleClip 的实例。
CreateRectangleClip(Single, Single, Single, Single)	使用指定的边缘值创建 RectangleClip 的实例。
CreateRectangleClip(Single, Single, Single, Single, Vector2, Vector2, Vector2, Vector2)	使用指定的边缘和角半径值创建 RectangleClip 实例。
CreateRectangleGeometry()	创建 CompositionRectangleGeometry 的实例。
CreateRedirectVisual()	创建 RedirectVisual 的实例。
CreateRedirectVisual(Visual)	使用指定的源创建 RedirectVisual 的实例。
CreateRoundedRectangleGeometry()	创建 CompositionRoundedRectangleGeometry 的实例。
CreateScalarKeyFrameAnimation()	创建 ScalarKeyFrameAnimation 的实例。
CreateScopedBatch(CompositionBatchTypes)	创建 CompositionScopedBatch 的实例。
CreateShapeVisual()	创建 ShapeVisual 的实例。
CreateSpotLight()	创建 SpotLight 的实例。
CreateSpringScalarAnimation()	创建 SpringScalarNaturalMotionAnimation 的实例。
CreateSpringVector2Animation()	创建 SpringVector2NaturalMotionAnimation 的实例。
CreateSpringVector3Animation()	创建 SpringVector3NaturalMotionAnimation 的实例。
CreateSpriteShape()	创建 CompositionSpriteShape 的实例。
CreateSpriteShape(CompositionGeometry)	使用指定的几何图形创建 CompositionSpriteShape 的实例。
CreateSpriteVisual()	创建 SpriteVisual 的实例。
CreateStepEasingFunction()	创建 StepEasingFunction 的实例。
CreateStepEasingFunction(Int32)	使用指定的步骤计数创建 StepEasingFunction 的实例。
CreateSurfaceBrush()	创建 CompositionSurfaceBrush 的实例。
CreateSurfaceBrush(ICompositionSurface)	使用指定的合成图面创建 CompositionSurfaceBrush 的实例。
CreateTargetForCurrentView()	为当前视图创建 CompositionTarget 。
CreateVector2KeyFrameAnimation()	创建 Vector2KeyFrameAnimation 的实例。
CreateVector3KeyFrameAnimation()	创建 Vector3KeyFrameAnimation 的实例。
CreateVector4KeyFrameAnimation()	创建 Vector4KeyFrameAnimation 的实例。
CreateViewBox()	创建 CompositionViewBox 的实例。
CreateVisualSurface()	创建 CompositionVisualSurface 的实例。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
GetCommitBatch(CompositionBatchTypes)	检索当前提交周期的提交批处理。
RequestCommitAsync()	尝试异步启动提交周期。
TryCreateBlurredWallpaperBackdropBrush()	创建 的实例 CompositionBackdropBrush ，用于在当前视觉对象后面绘制模糊壁纸。

另请参阅

• IClosable
• 合成 UI 概述
• 合成可视化树概述
• 不使用框架示例 (Windows 10) 合成视觉对象
• 版本自适应代码示例