LampArray Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Lights

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un dispositivo LampArray collegato al sistema. Attualmente sono supportati solo 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

Ereditarietà: Object Platform::Object IInspectable LampArray

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Esempio

Esempio di LampArray

Illustra come controllare l'illuminazione RGB dei dispositivi periferici usando le API Windows.Devices.Lights e Windows.Devices.Lights.Effects.

Esempio di AutoRGB

Illustra come estrarre un singolo colore rappresentativo da uno schermo desktop e usarlo per illuminare le lampade LED su un dispositivo RGB connesso.

Commenti

I dispositivi LampArray hanno uno o più indici di lampada (ad esempio luci/LED/lampadine e così via...) il cui stato del colore può essere modificato direttamente. Le informazioni statiche (recuperate dal dispositivo) descrivono i colori supportati, le posizioni geometriche e gli scopi previsti per ogni indice della lampada.

Questi dispositivi possono essere trovati come parte di dispositivi compositi (ad esempio, tastiera con illuminazione RGB) o come autonomi.

Un'applicazione può impostare lo stato della lampada in qualsiasi momento, ma lo stato verrà applicato solo dal sistema mentre l'applicazione è in stato attivo.

LampArrays viene enumerato da DeviceWatcher e recuperato tramite FromIdAsync.

Proprietà

BoundingBox	Ottiene il rettangolo di selezione logico che include LampArray.
BrightnessLevel	Ottiene o imposta la luminosità complessiva della LampArray, dove 0,0 è completamente disattivata e 1,0 è la luminosità massima. Ogni lampada viene ridimensionata equamente dalla luminosità.
DeviceId	Ottiene l'identificatore del dispositivo plug and play (PnP) del dispositivo LampArray sottostante.
HardwareProductId	ID prodotto hardware del dispositivo sottostante.
HardwareVendorId	ID fornitore hardware del dispositivo sottostante.
HardwareVersion	Versione hardware del dispositivo sottostante.
IsAvailable	Ottiene se la matrice di lampade è disponibile o non disponibile per il controllo da questo processo.
IsConnected	Ottiene un valore che indica se il dispositivo LampArray è connesso al sistema.
IsEnabled	Ottiene o imposta lo stato abilitato.
LampArrayKind	Ottiene il tipo di dispositivo matrice di lampade.
LampCount	Numero di lampade parte di questo LampArray.
MinUpdateInterval	Intervallo minimo (richiesto dal dispositivo) tra il sistema che invia due aggiornamenti per qualsiasi lampada. Ciò è paragonabile alla velocità di aggiornamento effettiva del dispositivo.
SupportsVirtualKeys	Boolean che indica se una lampada viene mappata a una chiave virtuale.

Metodi

FromIdAsync(String)	Recupera un oggetto LampArray in modo asincrono per il dispositivo LampArray con il percorso di istanza del dispositivo plug and play (PnP) specificato.
GetDeviceSelector()	Recupera una stringa AQS (Advanced Query Syntax) che include tutti i dispositivi LampArray nel sistema.
GetIndicesForKey(VirtualKey)	Cerca tutti gli indici della lampada associati a VirtualKey specifici
GetIndicesForPurposes(LampPurposes)	Cerca tutti gli indici della lampada associati ai lampusi specificati.
GetLampInfo(Int32)	Recupera lampInfo corrispondente all'indice della lampada.
RequestMessageAsync(Int32)	Recupera in modo asincrono un IBuffer che rappresenta il messaggio identificato dall'argomento identifer del messaggio.
SendMessageAsync(Int32, IBuffer)	Invia in modo asincrono un messaggio identificato dall'argomento identifer del messaggio.
SetColor(Color)	Imposta ogni lampada appartenente alla LampArray al colore desiderato.
SetColorForIndex(Int32, Color)	Imposta la lampada corrispondente all'indice sul colore desiderato.
SetColorsForIndices(Color[], Int32[])	Imposta il colore per più lampade. La posizione all'interno di ogni matrice esegue il mapping dell'indice della lampada al colore desiderato.
SetColorsForKey(Color, VirtualKey)	Imposta il colore per tutte le lampade mappate alla chiave. Più lampade possono mappare alla stessa chiave.
SetColorsForKeys(Color[], VirtualKey[])	Imposta il colore di più lampade, corrispondente alle chiavi mappate. Posizione all'interno di ogni matrice esegue il mapping delle chiavi al colore desiderato.
SetColorsForPurposes(Color, LampPurposes)	Imposta il colore di più lampade, corrispondente a LampPurposes.
SetSingleColorForIndices(Color, Int32[])	Imposta tutte le lampade specificate sullo stesso colore.

Eventi

AvailabilityChanged

Viene generato quando il valore di IsAvailable cambia; che può verificarsi quando l'utente modifica l'accesso al sistema al dispositivo tramite le impostazioni del dispositivo.

I parametri del gestore eventi sono il mittente LampArray la cui proprietà è stata modificata e un oggetto (che è sempre Null).

Si applica a