다음을 통해 공유


BrightnessOverride 클래스

정의

BrightnessOverride 를 사용하면 애플리케이션이 디바이스에 대해 설정된 화면 밝기 수준을 재정의할 수 있습니다. 이 API를 사용하면 제어 가능한 밝기를 지원하는 디바이스에서 애플리케이션별 밝기 컨트롤을 사용할 수 있습니다.

BrightnessOverride를 사용하여 일시적으로 또는 영구적으로 사용자의 밝기 수준 설정을 재정의할 수 있습니다.

참고

GetDefaultForSystem 또는 GetForCurrentView에서 초기화된 BrightnessOverride 개체를 처음 검색하면 해당 개체의 BrightnessLevel 속성 값이 정의되지 않습니다(예: 값은 현재 시스템 밝기 수준을 나타내지 않음). 먼저 SetBrightnessLevel 을 호출하여 밝기 수준을 설정해야 합니다.

public ref class BrightnessOverride sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BrightnessOverride final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BrightnessOverride
Public NotInheritable Class BrightnessOverride
상속
Object Platform::Object IInspectable BrightnessOverride
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

속성

BrightnessLevel

BrightnessOverride instance 대한 화면 밝기 수준을 가져옵니다(이전에 SetBrightnessLevel을 호출하여 밝기 수준을 설정한 경우).

참고

GetDefaultForSystem 또는 GetForCurrentView에서 초기화된 BrightnessOverride 개체를 처음 검색하면 해당 개체의 BrightnessLevel 속성 값이 정의되지 않습니다(예: 값은 현재 시스템 밝기 수준을 나타내지 않음). 먼저 SetBrightnessLevel 을 호출하여 밝기 수준을 설정해야 합니다.

IsOverrideActive

밝기 재정의가 활성 상태인지 여부를 나타내는 BOOLEAN 값입니다. TRUE이면 현재 밝기 수준이 재정의 밝기 수준과 일치합니다. StartOverride()가 호출되지 않으면 이 속성 값은 항상 FALSE입니다.

IsSupported

디바이스에 현재 하나 이상의 밝기 제어 가능 디스플레이가 있는지 여부를 나타냅니다. TRUE이면 디바이스에 밝기 재정의를 지원하는 하나 이상의 밝기 제어 가능 디스플레이가 있습니다.

메서드

GetDefaultForSystem()

밝기 재정의 개체를 반환합니다. 이 메서드는 CoreWindow가 필요하지 않으므로 백그라운드에서 실행되는 앱에서 사용할 수 있습니다.

GetForCurrentView()

BrightnessOverride 개체를 반환합니다. 이 메서드에는 CoreWindow가 필요하므로 현재 창에서 실행 중인 앱에서만 사용할 수 있습니다. 반환된 밝기 재정의 개체는 동일한 스레드에서 BrightnessOverride.GetForCurrentView 에 대한 여러 호출 간에 동일하지 않을 수 있습니다.

기본 UI 스레드에서 BrightnessOverride.GetForCurrentView를 호출해야 합니다.

GetLevelForScenario(DisplayBrightnessScenario)

지정된 시나리오와 연결된 밝기 수준을 가져옵니다.

SaveForSystemAsync(BrightnessOverride)

이러한 값을 사용자 설정에 커밋하여 지정된 밝기 재정의 설정을 저장합니다. 재정의 중지 후 재정의 설정을 유지 하려면이 메서드를 사용 합니다. 에 대해 가 전달되면 null 시스템은 자동 밝기를 켭니다.

SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)

밝기 수준 및 재정의 옵션을 설정합니다. 앱이 재정의하려는 내용으로 현재 밝기를 변경할 준비가 되면 StartOverride를 호출합니다.

SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)

잘 알려진 밝기 수준이 있는 시나리오와 밝기 재정의의 재정의 옵션을 지정하여 밝기 수준을 설정합니다.

StartOverride()

화면 밝기 수준 재정의를 시작하도록 요청합니다. 재정의를 시작하라는 요청이 화면 밝기 수준이 항상 지정된 재정의 밝기 수준과 일치하도록 변경된다는 의미는 아닙니다. 이 재정의 요청을 적용할지 여부를 결정하는 것은 여전히 시스템에 달려 있습니다. IsOverrideActiveIsOverrideActiveChanged 속성을 사용하여 시스템이 재정의 요청을 적용했는지 확인합니다.

StopOverride()

밝기 수준 재정의를 중지합니다.

이벤트

BrightnessLevelChanged

화면 밝기 수준이 변경되면 발생합니다.

IsOverrideActiveChanged

화면 밝기 수준이 일치하기 시작하거나 재정의 밝기 수준과 일치하도록 중지할 때 발생합니다. 이 이벤트는 IsOverrideActive 속성이 상태를 변경할 때 발생합니다.

IsSupportedChanged

밝기 제어 가능한 디스플레이가 검색되거나 제거될 때 발생합니다. 이 이벤트는 IsSupported 속성이 변경될 때 발생합니다.

적용 대상