CompositionLight 类

定义

命名空间:

Windows.UI.Composition

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

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

public ref class CompositionLight : CompositionObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionLight : CompositionObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CompositionLight : CompositionObject

Public Class CompositionLight
Inherits CompositionObject

继承

Object Platform::Object IInspectable CompositionObject CompositionLight

派生

Windows.UI.Composition.AmbientLight

Windows.UI.Composition.DistantLight

Windows.UI.Composition.PointLight

Windows.UI.Composition.SpotLight

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

CompositionLight 是四种光类型的基类。

亮	说明
AmbientLight	发出非定向光的光源，该光似乎已由场景中的所有内容反射。
DistantLight	在一个方向上发出光的无限远的光源。
PointLight	在所有方向上发出光的点光源。
SpotLight	发出内部和外部光锥的光源。

注意

一个视觉对象不能被两个以上的非环境光 (PointLight、SpotLight 或 DistantLight) 作为目标。

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	ExclusionsFromTargets
1803	17134	IsEnabled

属性

Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject)
Dispatcher	CompositionObject 的调度程序。 (继承自 CompositionObject)
DispatcherQueue	获取 CompostionObject 的 DispatcherQueue 。 (继承自 CompositionObject)
ExclusionsFromTargets	获取不以光线为目标的视觉对象的集合。
ImplicitAnimations	附加到此 对象的隐式动画的集合。 (继承自 CompositionObject)
IsEnabled	获取或设置一个值，该值确定合成灯是否亮起。
Properties	与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject)
Targets	以光线为目标的视觉对象的集合。

方法

Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	连接和动画。 (继承自 CompositionObject)
DisconnectAnimation(String)	断开动画的连接。 (继承自 CompositionObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。 (继承自 CompositionObject)
StopAnimation(String)	断开动画与指定属性的连接，并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)

另请参阅

• CompositionObject
• Targets
• CreateAmbientLight()
• CreatePointLight()
• CreateSpotLight()
• CreateDistantLight()