LampArray 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示连接到系统的 LampArray 设备。 目前，仅支持 HID LampArrays 。
public ref class LampArray sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LampArray final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LampArrayPublic NotInheritable Class LampArray- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10, version 1809 (在 10.0.17763.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v7.0 中引入)
|
示例
演示如何使用 Windows.Devices.Lights 和 Windows.Devices.Lights.Effects API 控制外围设备的 RGB 照明。
演示如何从桌面屏幕中提取具有代表性的单一颜色，并使用它来照亮连接的 RGB 设备上的 LED 灯。
注解
LampArray 设备具有一个或多个灯索引， (例如灯/LED/灯泡等...) 可以直接操作其颜色状态。 (从设备检索的静态信息) 描述每个灯索引支持的颜色、几何位置和预期用途。
这些设备可作为复合设备的一部分找到， (例如，具有 RGB 照明) 的键盘或独立设备。
应用程序可以随时设置灯状态，但状态只会在应用程序处于焦点时由系统应用。
LampArrays 由 DeviceWatcher 枚举，并通过 FromIdAsync 检索。
属性
| BoundingBox |
获取包含 LampArray 的逻辑边界框。 |
| BrightnessLevel |
获取或设置 LampArray 的总体亮度，其中 0.0 完全关闭，1.0 是最大亮度。 每个灯都按亮度平均缩放。 |
| DeviceId |
获取基础 LampArray 设备的即插即用 (PnP) 设备标识符。 |
| HardwareProductId |
基础设备的硬件产品 ID。 |
| HardwareVendorId |
基础设备的硬件供应商 ID。 |
| HardwareVersion |
基础设备的硬件版本。 |
| IsAvailable |
获取灯阵列是否可供此过程控制。 |
| IsConnected |
获取一个值，该值指示 LampArray 设备是否已连接到系统。 |
| IsEnabled |
获取或设置启用状态。 |
| LampArrayKind |
获取灯阵列设备的类型。 |
| LampCount |
此 LampArray 的灯数。 |
| MinUpdateInterval |
设备) 系统之间为任意一个灯发送两个更新所需的最小间隔 (。 这相当于有效的设备刷新率。 |
| SupportsVirtualKeys |
指示是否有任何灯映射到虚拟键的布尔值。 |
方法
| FromIdAsync(String) |
异步检索 LampArray 设备的 LampArray 对象，该对象具有指定的即插即用 (PnP) 设备标识符/设备实例路径。 |
| GetDeviceSelector() |
检索包含系统上所有 LampArray 设备的 AQS) 字符串 (高级查询语法。 |
| GetIndicesForKey(VirtualKey) |
搜索绑定到特定 VirtualKey 的所有灯索引 |
| GetIndicesForPurposes(LampPurposes) |
搜索绑定到指定 LampPurposes 的所有灯索引。 |
| GetLampInfo(Int32) |
提取对应于灯索引的 LampInfo 。 |
| RequestMessageAsync(Int32) |
异步检索表示由消息标识符参数标识的消息的 IBuffer 。 |
| SendMessageAsync(Int32, IBuffer) |
异步发送由消息标识符参数标识的消息。 |
| SetColor(Color) |
将属于 LampArray 的每个灯设置为所需的颜色。 |
| SetColorForIndex(Int32, Color) |
将对应于索引的灯设置为所需的颜色。 |
| SetColorsForIndices(Color[], Int32[]) |
设置多个灯的颜色。 每个数组中的位置将灯索引映射到所需的颜色。 |
| SetColorsForKey(Color, VirtualKey) | |
| SetColorsForKeys(Color[], VirtualKey[]) | |
| SetColorsForPurposes(Color, LampPurposes) |
设置对应于 LampPurposes 的多个灯的颜色。 |
| SetSingleColorForIndices(Color, Int32[]) |
将指定的所有灯设置为相同颜色。 |
事件
| AvailabilityChanged |
当 IsAvailable 的值更改时引发;当用户通过设备设置更改对设备的系统访问权限时，可能会发生这种情况。 事件处理程序的参数是属性已更改的发送方 LampArray ，以及始终为 null) Object (。 |