LampArray Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un dispositivo LampArray conectado al sistema. Actualmente, solo se admiten 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- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)
|
Ejemplos
Muestra cómo controlar la iluminación RGB de los dispositivos periféricos mediante las API Windows.Devices.Lights y Windows.Devices.Lights.Effects .
Muestra cómo extraer un único color representativo de una pantalla de escritorio y usarlo para iluminar lámparas LED en un dispositivo RGB conectado.
Comentarios
Los dispositivos LampArray tienen uno o más índices de lámpara (por ejemplo, luces/LED/bombillas, etc.) cuyo estado de color se puede manipular directamente. La información estática (recuperada del dispositivo) describe los colores admitidos, las posiciones geométricas y los propósitos previstos para cada índice de lámpara.
Estos dispositivos se pueden encontrar como parte de dispositivos compuestos (por ejemplo, teclado con iluminación RGB) o como independiente.
Una aplicación puede establecer el estado de la lámpara en cualquier momento, pero el sistema solo aplicará el estado mientras la aplicación está en el foco.
LampArrays se enumeran mediante DeviceWatcher y se recuperan a través de FromIdAsync.
Propiedades
| BoundingBox |
Obtiene el rectángulo delimitador lógico que abarca LampArray. |
| BrightnessLevel |
Obtiene o establece el brillo general de LampArray, donde 0,0 está completamente desactivado y 1,0 es el brillo máximo. Cada lámpara se escala igualmente por el brillo. |
| DeviceId |
Obtiene el identificador de dispositivo plug and play (PnP) del dispositivo LampArray subyacente. |
| HardwareProductId |
Identificador de producto de hardware del dispositivo subyacente. |
| HardwareVendorId |
Identificador del proveedor de hardware del dispositivo subyacente. |
| HardwareVersion |
Versión de hardware del dispositivo subyacente. |
| IsAvailable |
Obtiene si la matriz de lámpara está disponible o no está disponible para el control por este proceso. |
| IsConnected |
Obtiene un valor que indica si el dispositivo LampArray está conectado al sistema. |
| IsEnabled |
Obtiene o establece el estado habilitado. |
| LampArrayKind |
Obtiene el tipo de dispositivo de matriz de lámpara. |
| LampCount |
El número de lámparas que forman parte de este LampArray. |
| MinUpdateInterval |
Intervalo mínimo (requerido por el dispositivo) entre el sistema que envía dos actualizaciones para cualquier lámpara. Esto es comparable a la frecuencia de actualización efectiva del dispositivo. |
| SupportsVirtualKeys |
Boolean que indica si alguna lámpara está asignada a una clave virtual. |
Métodos
| FromIdAsync(String) |
Recupera un objeto LampArray de forma asincrónica para el dispositivo LampArray que tiene la ruta de acceso especificada del dispositivo plug and play (PnP). |
| GetDeviceSelector() |
Recupera una cadena de sintaxis de consulta avanzada (AQS) que abarca todos los dispositivos LampArray del sistema. |
| GetIndicesForKey(VirtualKey) |
Busca todos los índices de lámpara enlazados a la clave virtual específica. |
| GetIndicesForPurposes(LampPurposes) |
Busca todos los índices de lámpara enlazados a lampPurposes especificados. |
| GetLampInfo(Int32) |
Captura lampInfo correspondiente al índice de la lámpara. |
| RequestMessageAsync(Int32) |
Recupera de forma asincrónica un IBuffer que representa el mensaje identificado por el argumento de identificador del mensaje. |
| SendMessageAsync(Int32, IBuffer) |
Envía de forma asincrónica un mensaje identificado por el argumento identifer del mensaje. |
| SetColor(Color) |
Establece todas las lámparas que pertenecen a LampArray en el color deseado. |
| SetColorForIndex(Int32, Color) |
Establece la lámpara correspondiente al índice en el color deseado. |
| SetColorsForIndices(Color[], Int32[]) |
Establece el color de varias lámparas. La posición dentro de cada matriz asigna el índice de la lámpara al color deseado. |
| SetColorsForKey(Color, VirtualKey) |
Establece el color de todas las lámparas que se asignan a la clave. Varias lámparas pueden asignarse a la misma clave. |
| SetColorsForKeys(Color[], VirtualKey[]) |
Establece el color de varias lámparas, correspondientes a las teclas asignadas. La posición dentro de cada matriz asigna las claves al color deseado. |
| SetColorsForPurposes(Color, LampPurposes) |
Establece el color de varias lámparas, correspondientes a LampPurposes. |
| SetSingleColorForIndices(Color, Int32[]) |
Establece todas las lámparas especificadas en el mismo color. |
Eventos
| AvailabilityChanged |
Se genera cuando cambia el valor de IsAvailable ; lo que puede ocurrir cuando el usuario cambia el acceso del sistema al dispositivo a través de la configuración del dispositivo. Los parámetros del controlador de eventos son el remitente LampArray cuya propiedad ha cambiado y un objeto (que siempre es null). |