LampArray 類別

定義

命名空間:

Windows.Devices.Lights

代表連結系統的 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 LampArray

Public NotInheritable Class LampArray

繼承

Object Platform::Object IInspectable LampArray

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v7.0 引進)

範例

LampArray 範例

示範如何使用Windows.Devices.Lights 和 Windows.Devices.Lights.Effects API 來控制周邊裝置的 RGB 光源。

AutoRGB 範例

示範如何從桌面畫面擷取單一代表性色彩，並用它來在連接的 RGB 裝置上亮起 LED 燈。

備註

LampArray 裝置有一或多個燈光索引 (例如燈/LED/燈泡等...) 可以直接操作其色彩狀態。 從裝置 (擷取的靜態資訊) 描述每個燈光索引支援的色彩、幾何位置和預定用途。

這些裝置可以在複合裝置 (中找到，例如具有 RGB 光源的鍵盤) 或獨立式。

應用程式可以隨時設定燈光狀態，但只有在應用程式處於焦點時，系統才會套用狀態。

LampArrays 是由 DeviceWatcher列舉，並透過 FromIdAsync擷取。

屬性

BoundingBox	取得包含 LampArray 的邏輯周框方塊。
BrightnessLevel	取得或設定 LampArray 的整體亮度，其中 0.0 完全關閉，而 1.0 是最大亮度。 每個燈光都會以亮度平均縮放。
DeviceId	取得基礎 LampArray 裝置的隨插即用 (PnP) 裝置識別碼。
HardwareProductId	基礎裝置的硬體產品識別碼。
HardwareVendorId	基礎裝置的硬體廠商識別碼。
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 ，其屬性已變更，而 Object (一律為 null) 。

另請參閱

• 光源和光源 (www.usb.org)
• 動態光源