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

Демонстрирует, как управлять rgb-освещением периферийных устройств с помощью API Windows.Devices.Lights и Windows.Devices.Lights.Effects .

Пример AutoRGB

Демонстрирует, как извлечь один репрезентативный цвет с экрана рабочего стола и использовать его для освещения светодиодных ламп на подключенном устройстве 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).

Применяется к

См. также раздел