SpotLight 类

定义

命名空间:

Microsoft.UI.Composition

投射内锥和外锥光的光源。 例如，手电筒。

public ref class SpotLight sealed : CompositionLight

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class SpotLight final : CompositionLight

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class SpotLight : CompositionLight

Public NotInheritable Class SpotLight
Inherits CompositionLight

继承

Object Platform::Object IInspectable CompositionObject CompositionLight SpotLight

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

_spotLight = _compositor.CreateSpotLight(); 
_spotLight.CoordinateSpace = root; 
_spotLight.InnerConeAngleInDegrees = 30; 
_spotLight.InnerConeColor = Colors.Red; 
_spotLight.OuterConeAngleInDegrees = 45; 
_spotLight.OuterConeColor = Colors.Yellow; 
_spotLight.Offset = new Vector3(30, 30, 200); 
_spotLight.Targets.Add(root); 

注解

SpotLight 是派生自 CompositionLight 的四种光类型之一。

亮

说明

注意 一个视觉对象不能被两个以上的非环境光 (PointLight、SpotLight 或 DistantLight) 作为目标。 属性 Comment 要与 CompositionObject 关联的字符串。 (继承自 CompositionObject) Compositor 用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject) ConstantAttenuation 光衰减等式中的常量系数。 控制光强度。 可进行动画处理。 CoordinateSpace 用于确定光线方向和偏移量的视觉对象。 光的偏移量和方向属性相对于此视觉对象的坐标空间。 SpotLight.CoordinateSpace 是必需属性。 如果未设置 SpotLight.CoordinateSpace ，则 SpotLight 将不会呈现。 Direction 光线指向的方向，相对于其坐标空间视觉对象指定。 DispatcherQueue 获取 CompositionObject 的 DispatcherQueue。 (继承自 CompositionObject) ExclusionsFromTargets 获取不以光线为目标的视觉对象的集合。 (继承自 CompositionLight) ImplicitAnimations 附加到此 对象的隐式动画的集合。 (继承自 CompositionObject) InnerConeAngle SpotLight 的内锥角，以弧度表示为半垂直角度。 可进行动画处理。 InnerConeAngleInDegrees SpotLight 的内锥角，以半垂直角度表示（以度为单位）。 可进行动画处理。 InnerConeColor 聚光灯内部圆锥的颜色。 可进行动画处理。 InnerConeIntensity 获取或设置聚光内锥体中光的强度。 IsEnabled 获取或设置一个值，该值确定合成灯是否亮起。 (继承自 CompositionLight) LinearAttenuation 光衰减等式中的线性系数，用于确定光如何随距离脱落。 可进行动画处理。 MaxAttenuationCutoff 获取或设置此光有效的最大范围。 MinAttenuationCutoff 获取或设置此光有效时的最小范围。 Offset 光源相对于其 坐标空间 视觉对象的偏移量。 可进行动画处理。 OuterConeAngle SpotLight 的外锥角，以弧度表示为半垂直角度。 可进行动画处理。 OuterConeAngleInDegrees SpotLight 外锥的半垂直角度（以度为单位）。 可进行动画处理。 OuterConeColor 聚光灯外锥的颜色。 可进行动画处理。 OuterConeIntensity 获取或设置聚光外锥体中光线的强度。 Properties 与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject) QuadraticAttenuation 衰减等式的二次部分，用于确定光线如何随距离脱落。 可进行动画处理。 Targets 以光线为目标的视觉对象的集合。 (继承自 CompositionLight) 方法 Close() 关闭 CompositionObject 并释放系统资源。 (继承自 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) 另请参阅 CompositionLight Targets CreateSpotLight()