LampArray Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um dispositivo LampArray anexado ao sistema. Atualmente, há suporte apenas para LAMPArrays HID .
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1809 (introduzida na 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v7.0)
|
Exemplos
Demonstra como controlar a iluminação RGB de dispositivos periféricos usando as APIs Windows.Devices.Lights e Windows.Devices.Lights.Effects .
Demonstra como extrair uma única cor representativa de uma tela de desktop e usá-la para iluminar lâmpadas LED em um dispositivo RGB conectado.
Comentários
Os dispositivos LampArray têm um ou mais índices de lâmpada (por exemplo, luzes/LEDs/lâmpadas etc.) cujo estado de cor pode ser manipulado diretamente. As informações estáticas (recuperadas do dispositivo) descrevem cores com suporte, posições geométricas e finalidades pretendidas para cada índice de lâmpada.
Esses dispositivos podem ser encontrados como parte de dispositivos compostos (por exemplo, teclado com iluminação RGB) ou como autônomos.
Um aplicativo pode definir o estado da lâmpada a qualquer momento, mas o estado só será aplicado pelo sistema enquanto o aplicativo estiver em foco.
LampArrays são enumerados por DeviceWatcher e recuperados por meio de FromIdAsync.
Propriedades
| BoundingBox |
Obtém a caixa delimitadora lógica que abrange o LampArray. |
| BrightnessLevel |
Obtém ou define o brilho geral do LampArray, em que 0,0 está completamente desativado e 1,0 é o brilho máximo. Cada lâmpada é dimensionada igualmente pelo brilho. |
| DeviceId |
Obtém o identificador de dispositivo PnP (plug and play) do dispositivo LampArray subjacente. |
| HardwareProductId |
A ID do produto de hardware do dispositivo subjacente. |
| HardwareVendorId |
A ID do fornecedor de hardware do dispositivo subjacente. |
| HardwareVersion |
A versão de hardware do dispositivo subjacente. |
| IsAvailable |
Obtém se a matriz de lâmpadas está disponível ou indisponível para controle por esse processo. |
| IsConnected |
Obtém um valor que indica se o dispositivo LampArray está conectado ao sistema. |
| IsEnabled |
Obtém ou define o estado habilitado. |
| LampArrayKind |
Obtém o tipo de dispositivo de matriz de lâmpadas. |
| LampCount |
O número de lâmpadas parte deste LampArray. |
| MinUpdateInterval |
Intervalo mínimo (exigido pelo dispositivo) entre o sistema que envia duas atualizações para qualquer lâmpada. Isso é comparável à taxa de atualização efetiva do dispositivo. |
| SupportsVirtualKeys |
Booliano que indica se alguma lâmpada é mapeada para uma chave virtual. |
Métodos
| FromIdAsync(String) |
Recupera um objeto LampArray de forma assíncrona para o dispositivo LampArray que tem o caminho de instância do dispositivo PnP (plug and play) especificado. |
| GetDeviceSelector() |
Recupera uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) que abrange todos os dispositivos LampArray no sistema. |
| GetIndicesForKey(VirtualKey) |
Pesquisa todos os índices de lâmpada associados à VirtualKey específica |
| GetIndicesForPurposes(LampPurposes) |
Pesquisa todos os índices de lâmpadas associados aos LampPurposes especificados. |
| GetLampInfo(Int32) |
Busca o LampInfo correspondente ao índice da lâmpada. |
| RequestMessageAsync(Int32) |
Recupera de forma assíncrona um IBuffer que representa a mensagem identificada pelo argumento identifer da mensagem. |
| SendMessageAsync(Int32, IBuffer) |
Envia de forma assíncrona uma mensagem identificada pelo argumento identifer da mensagem. |
| SetColor(Color) |
Define cada lâmpada que pertence ao LampArray como a cor desejada. |
| SetColorForIndex(Int32, Color) |
Define a lâmpada correspondente ao índice como a cor desejada. |
| SetColorsForIndices(Color[], Int32[]) |
Define a cor de várias lâmpadas. A posição dentro de cada matriz mapeia o índice da lâmpada para a cor desejada. |
| SetColorsForKey(Color, VirtualKey) |
Define a cor de todas as lâmpadas mapeadas para a chave. Várias lâmpadas podem ser mapeadas para a mesma chave. |
| SetColorsForKeys(Color[], VirtualKey[]) |
Define a cor de várias lâmpadas, correspondentes às teclas mapeadas. A posição dentro de cada matriz mapeia as chaves para a cor desejada. |
| SetColorsForPurposes(Color, LampPurposes) |
Define a cor de várias lâmpadas, correspondentes a LampPurposes. |
| SetSingleColorForIndices(Color, Int32[]) |
Define todas as lâmpadas especificadas com a mesma cor. |
Eventos
| AvailabilityChanged |
É gerado quando o valor de IsAvailable é alterado; o que pode acontecer quando o usuário altera o acesso do sistema ao dispositivo por meio das configurações do dispositivo. Os parâmetros do manipulador de eventos são o remetente LampArray cuja propriedade foi alterada e um Object (que é sempre nulo). |