LampArray 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
시스템에 연결된 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에서 도입되었습니다.)
|
예제
Windows.Devices.Lights 및 Windows.Devices.Lights.Effects API를 사용하여 주변 장치의 RGB 조명을 제어하는 방법을 보여 줍니다.
데스크톱 화면에서 대표적인 단일 색을 추출하고 이를 사용하여 연결된 RGB 디바이스에서 LED 램프를 비추는 방법을 보여 줍니다.
설명
LampArray 디바이스에는 색 상태를 직접 조작할 수 있는 하나 이상의 램프 인덱스(예: 조명/LED/전구 등)가 있습니다. 정적 정보(디바이스에서 검색됨)는 각 램프 인덱스에 대해 지원되는 색, 기하학적 위치 및 의도된 용도를 설명합니다.
이러한 디바이스는 복합 디바이스(예: RGB 조명이 있는 키보드)의 일부 또는 독립 실행형으로 찾을 수 있습니다.
애플리케이션은 언제든지 램프 상태를 설정할 수 있지만 애플리케이션이 포커스가 있는 동안에는 시스템에서만 상태가 적용됩니다.
LampArrays는 DeviceWatcher에 의해 열거되고 FromIdAsync를 통해 검색됩니다.
속성
| BoundingBox |
LampArray를 포함하는 논리적 경계 상자를 가져옵니다. |
| BrightnessLevel |
0.0이 완전히 꺼지고 1.0이 최대 밝기인 LampArray의 전체 밝기를 가져오거나 설정합니다. 모든 램프는 밝기별로 동일하게 조정됩니다. |
| DeviceId |
기본 LampArray 디바이스의 플러그 앤 플레이(PnP) 디바이스 식별자를 가져옵니다. |
| HardwareProductId |
기본 디바이스의 하드웨어 제품 ID입니다. |
| HardwareVendorId |
기본 디바이스의 하드웨어 공급업체 ID입니다. |
| HardwareVersion |
기본 디바이스의 하드웨어 버전입니다. |
| IsAvailable |
이 프로세스에서 램프 배열을 제어할 수 있는지 여부를 가져옵니다. |
| IsConnected |
LampArray 디바이스가 시스템에 연결되어 있는지 여부를 나타내는 값을 가져옵니다. |
| IsEnabled |
사용 상태를 가져오거나 설정합니다. |
| LampArrayKind |
램프 배열 디바이스의 유형을 가져옵니다. |
| LampCount |
이 LampArray의 램프 부분 수입니다. |
| MinUpdateInterval |
하나의 램프에 대해 두 개의 업데이트를 보내는 시스템 간의 최소 간격(디바이스에 필요)입니다. 이는 효과적인 디바이스 새로 고침 속도와 비슷합니다. |
| SupportsVirtualKeys |
램프가 가상 키에 매핑되는지 여부를 나타내는 부울입니다. |
메서드
| FromIdAsync(String) |
지정된 PnP(플러그 앤 플레이) 디바이스 식별자/디바이스 instance 경로가 있는 LampArray 디바이스에 대해 LampArray 개체를 비동기적으로 검색합니다. |
| GetDeviceSelector() |
시스템의 모든 LampArray 디바이스를 포함하는 AQS(고급 쿼리 구문) 문자열을 검색합니다. |
| GetIndicesForKey(VirtualKey) |
특정 VirtualKey에 바인딩된 모든 램프 인덱스를 검색합니다. |
| GetIndicesForPurposes(LampPurposes) |
지정된 LampPurposes에 바인딩된 모든 램프 인덱스를 검색합니다. |
| GetLampInfo(Int32) |
램프 인덱스에 해당하는 LampInfo 를 가져옵니다. |
| RequestMessageAsync(Int32) |
메시지 identifer 인수로 식별된 메시지를 나타내는 IBuffer 를 비동기적으로 검색합니다. |
| SendMessageAsync(Int32, IBuffer) |
메시지 identifer 인수로 식별된 메시지를 비동기적으로 보냅니다. |
| 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임)입니다. |