LampArray Kelas

Referensi

Definisi

Ruang nama:: Windows.Devices.Lights

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili perangkat LampArray yang melekat pada sistem. Saat ini, hanya HID LampArrays yang didukung.

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

Warisan: Object Platform::Object IInspectable LampArray

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Contoh

Sampel LampArray

Menunjukkan cara mengontrol pencahayaan RGB perangkat periferal menggunakan API Windows.Devices.Lights dan Windows.Devices.Lights.Effects .

Sampel AutoRGB

Menunjukkan cara mengekstrak satu warna representatif dari layar desktop dan menggunakannya untuk menerangi lampu LED pada perangkat RGB yang terhubung.

Keterangan

Perangkat LampArray memiliki satu atau beberapa indeks lampu (misalnya, lampu/LED/bohlam, dll...) yang status warnanya dapat langsung dimanipulasi. Informasi statis (diambil dari perangkat) menjelaskan warna yang didukung, posisi geometris, dan tujuan yang dimaksudkan untuk setiap indeks lampu.

Perangkat ini dapat ditemukan sebagai bagian dari perangkat komposit (misalnya, keyboard dengan pencahayaan RGB) atau sebagai mandiri.

Aplikasi dapat mengatur status lampu kapan saja, tetapi status hanya akan diterapkan oleh sistem saat aplikasi sedang fokus.

LampArrays dijumlahkan oleh DeviceWatcher, dan diambil melalui FromIdAsync.

Properti

BoundingBox	Mendapatkan kotak pembatas logis yang mencakup LampArray.
BrightnessLevel	Mendapatkan atau mengatur kecerahan keseluruhan LampArray, di mana 0,0 benar-benar mati dan 1,0 adalah kecerahan maksimum. Setiap lampu diskalakan sama dengan kecerahannya.
DeviceId	Mendapatkan pengidentifikasi perangkat plug and play (PnP) dari perangkat LampArray yang mendasar.
HardwareProductId	Id produk perangkat keras dari perangkat yang mendasar.
HardwareVendorId	Id vendor perangkat keras dari perangkat yang mendasar.
HardwareVersion	Versi perangkat keras dari perangkat yang mendasar.
IsAvailable	Mendapatkan apakah array lampu tersedia atau tidak tersedia untuk dikontrol oleh proses ini.
IsConnected	Mendapatkan nilai yang menunjukkan apakah perangkat LampArray terhubung ke sistem.
IsEnabled	Mendapatkan atau mengatur status yang diaktifkan.
LampArrayKind	Mendapatkan jenis perangkat array lampu.
LampCount	Jumlah lampu bagian dari LampArray ini.
MinUpdateInterval	Interval minimal (diperlukan oleh perangkat) antara sistem yang mengirim dua pembaruan untuk satu lampu. Ini sebanding dengan kecepatan refresh perangkat yang efektif.
SupportsVirtualKeys	Boolean menunjukkan apakah ada lampu yang dipetakan ke kunci virtual.

Metode

FromIdAsync(String)	Mengambil objek LampArray secara asinkron untuk perangkat LampArray yang memiliki jalur pengidentifikasi perangkat/perangkat plug and play (PnP) yang ditentukan.
GetDeviceSelector()	Mengambil string Advanced Query Syntax (AQS) yang mencakup semua perangkat LampArray pada sistem.
GetIndicesForKey(VirtualKey)	Mencari semua indeks lampu yang terikat ke VirtualKey tertentu
GetIndicesForPurposes(LampPurposes)	Mencari semua indeks lampu yang terikat ke LampPurposes yang ditentukan.
GetLampInfo(Int32)	Mengambil LampInfo yang sesuai dengan indeks lampu.
RequestMessageAsync(Int32)	Secara asinkron mengambil IBuffer yang mewakili pesan yang diidentifikasi oleh argumen pengidentifikasi pesan.
SendMessageAsync(Int32, IBuffer)	Secara asinkron mengirim pesan yang diidentifikasi oleh argumen pengidentifikasi pesan.
SetColor(Color)	Mengatur setiap lampu milik LampArray ke warna yang diinginkan.
SetColorForIndex(Int32, Color)	Mengatur lampu yang sesuai dengan indeks dengan warna yang diinginkan.
SetColorsForIndices(Color[], Int32[])	Mengatur warna untuk beberapa lampu. Posisi dalam setiap indeks lampu peta array ke warna yang diinginkan.
SetColorsForKey(Color, VirtualKey)	Mengatur warna untuk semua lampu yang memetakan ke kunci. Beberapa lampu dapat memetakan ke kunci yang sama.
SetColorsForKeys(Color[], VirtualKey[])	Mengatur warna beberapa lampu, sesuai dengan kunci yang dipetakan. Posisi dalam setiap array memetakan kunci ke warna yang diinginkan.
SetColorsForPurposes(Color, LampPurposes)	Mengatur warna beberapa lampu, sesuai dengan LampPurposes.
SetSingleColorForIndices(Color, Int32[])	Mengatur semua lampu yang ditentukan ke warna yang sama.

Acara

AvailabilityChanged

Dimunculkan ketika nilai IsAvailable berubah ; yang dapat terjadi ketika pengguna mengubah akses sistem ke perangkat melalui pengaturan perangkat.

Parameter penanganan aktivitas adalah pengirim LampArray yang propertinya telah berubah, dan Objek (yang selalu null).

Berlaku untuk

Bagikan melalui