XamlLight 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供用于创建 XAML 光的基类，该基类使用 CompositionLight 将照明效果应用于 XAML 元素和画笔。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XamlLight : DependencyObject[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class XamlLight : DependencyObjectPublic Class XamlLight
Inherits DependencyObject- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 Creators Update (在 10.0.15063.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v4.0 中引入)
|
示例
请参阅 照明中的代码示例。
注解
可以使用 XamlLight 创建自定义灯光。
例如，它可用于创建一个光，将合成 SpotLight 应用于目标元素以点亮它们。
XamlLight 提供了方法以用于面向 UIElement 或 XAML 画笔、将光应用于 UIElement 树以及帮助管理 CompositionLight 资源的生存期（根据它们当前是否已使用）。
自定义 XamlLight 可以与派生自 XamlCompositionBrushBase 的自定义画笔结合使用，后者使用 SceneLightingEffect 在 XamlLight 点亮时控制元素的反射属性。
目标对象
如果使用 XamlLight 面向某个画笔，则光会照亮使用该画笔的任何 UIElement 的位置。
如果使用 XamlLight 面向某个 UIElement，则光会照亮整个 UIElement 及其子 UIElement。
可以通过在 XamlLight 实例上调用方法来添加和删除目标。 XamlLights 还可以定义 自定义附加属性 ，以在标记中添加和删除目标。
管理资源
创建 XamlLight 时，通常最好延迟创建 CompositionLight 和任何相关资源，直到使用光。 当 XamlLight 首次用于在屏幕上以元素或画笔为目标时，将调用 OnConnected 方法，因此你可以替代 OnConnected ，以便仅在需要时安全地创建资源。
当组合资源不再使用时，处理组合资源也是一种很好的做法。 当屏幕上的任何位置不再使用 XamlLight 实例时，将调用 OnDisconnected 方法，因此你可以替代 OnDisconnected 以安全地释放资源。 如果在断开连接后再次使用 XamlLight，则将再次调用 OnConnected 。
警告
在 Windows 10 创意者更新 (SDK 15063) 上，调用 Dispose 后无法访问 CompositionLight，因此在调用 Dispose 后将其设置为 null 会导致错误。 若要解决此问题，可以将 CompositionLight 保存到临时变量，并在将 CompositionLight 设置为 null 后在该变量上调用 Dispose。 var temp = CompostionLight; CompositionLight = null; temp.Dispose(); 此问题在更高版本的 SDK 中已修复。 有关如何面向不同 SDK 版本的信息，请参阅 版本自适应应用 。
构造函数
| XamlLight() |
初始化 XamlLight 类的新实例。 |
属性
| CompositionLight |
获取或设置用于应用照明效果的 CompositionLight 实例。 |
| Dispatcher |
获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject) |