LampArray Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет устройство 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)
|
Примеры
Демонстрирует, как управлять rgb-освещением периферийных устройств с помощью API Windows.Devices.Lights и Windows.Devices.Lights.Effects .
Демонстрирует, как извлечь один репрезентативный цвет с экрана рабочего стола и использовать его для освещения светодиодных ламп на подключенном устройстве RGB.
Комментарии
Устройства LampArray имеют один или несколько индексов ламп (например, индикаторы, лампочки и т. д.), цветом которых можно управлять напрямую. Статические сведения (полученные с устройства) описывают поддерживаемые цвета, геометрические положения и предполагаемые цели для каждого индекса лампы.
Эти устройства можно найти как часть составных устройств (например, клавиатура с rgb-освещением) или как автономные.
Приложение может задать состояние лампы в любое время, но состояние будет применяться системой только в то время, когда приложение находится в фокусе.
LampArrays перечисляются с помощью DeviceWatcher и извлекаются с помощью FromIdAsync.
Свойства
| BoundingBox |
Возвращает логический ограничивающий прямоугольник, охватывающий Объект LampArray. |
| BrightnessLevel |
Возвращает или задает общую яркость LampArray, где 0,0 полностью выключено, а 1,0 — максимальная яркость. Каждая лампа масштабируется одинаково по яркости. |
| DeviceId |
Возвращает идентификатор устройства Plug and Play (PnP) базового устройства LampArray. |
| HardwareProductId |
Идентификатор аппаратного продукта базового устройства. |
| HardwareVendorId |
Идентификатор поставщика оборудования базового устройства. |
| HardwareVersion |
Версия оборудования базового устройства. |
| IsAvailable |
Возвращает значение, указывающее, является ли массив лампы доступным или недоступным для управления этим процессом. |
| IsConnected |
Возвращает значение, указывающее, подключено ли устройство LampArray к системе. |
| IsEnabled |
Возвращает или задает состояние enabled. |
| LampArrayKind |
Возвращает тип устройства массива ламп. |
| LampCount |
Количество ламп частью этого LampArray. |
| MinUpdateInterval |
Минимальный интервал (требуется устройством) между системой, отправляя два обновления для любой лампы. Это сравнимо с эффективной частотой обновления устройства. |
| SupportsVirtualKeys |
Логическое значение, указывающее, сопоставляется ли лампа с виртуальным ключом. |
Методы
| FromIdAsync(String) |
Асинхронно извлекает объект LampArray для устройства LampArray, которое имеет указанный идентификатор устройства plug and play (PnP) или путь к экземпляру устройства. |
| GetDeviceSelector() |
Извлекает строку расширенного синтаксиса запросов (AQS), охватывающую все устройства LampArray в системе. |
| 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). |