BrightnessOverride 类

定义

命名空间:

Windows.Graphics.Display

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

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

属性

BrightnessLevel	获取此 BrightnessOverride 实例 (的屏幕亮度级别（如果之前调用 SetBrightnessLevel 来设置) 亮度级别）。 注意 首次从 GetDefaultForSystem 或 GetForCurrentView 检索初始化的 BrightnessOverride 对象时，该对象的 BrightnessLevel 属性的值未定义， (该值不) 表示当前系统亮度级别。 需要首先调用 SetBrightnessLevel 来设置亮度级别。
IsOverrideActive	指示亮度替代是否处于活动状态的 BOOLEAN 值。 如果为 TRUE，则当前亮度级别与覆盖亮度级别匹配。 如果未调用 StartOverride () ，则此属性值将始终为 FALSE。
IsSupported	指示设备当前是否至少有一个亮度可控显示器。 如果为 TRUE，则设备至少有一个支持亮度替代的亮度可控显示器。

方法

GetDefaultForSystem()	返回亮度替代对象。 此方法不需要 CoreWindow ，因此它可以由在后台运行的应用使用。
GetForCurrentView()	返回 BrightnessOverride 对象。 此方法需要 CoreWindow，因此它只能由当前在窗口中运行的应用使用。 在同一线程上对 BrightnessOverride.GetForCurrentView 的多次调用之间，返回的亮度替代对象可能不同。 必须从main UI 线程调用 BrightnessOverride.GetForCurrentView。
GetLevelForScenario(DisplayBrightnessScenario)	获取与指定方案关联的亮度级别。
SaveForSystemAsync(BrightnessOverride)	通过将这些值提交到用户设置来保存指定的亮度替代设置。 使用此方法在重写停止后保留替代设置。 如果 null 为 值传递，则系统将打开自动亮度。
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	设置亮度级别和覆盖选项。 当应用准备好更改当前亮度时，请调用 StartOverride。
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	通过指定具有已知亮度级别的方案以及亮度替代的替代选项来设置亮度级别。
StartOverride()	请求开始覆盖屏幕亮度级别。 开始重写的请求并不意味着屏幕亮度级别始终更改以匹配指定的覆盖亮度级别。 仍由系统决定是否接受此替代请求。 使用 IsOverrideActive 和 IsOverrideActiveChanged 属性确定系统是否遵循了替代请求。
StopOverride()	停止重写亮度级别。

事件

BrightnessLevelChanged	在屏幕亮度级别更改时发生。
IsOverrideActiveChanged	当屏幕亮度级别开始匹配或停止以匹配覆盖亮度级别时发生。 当 IsOverrideActive 属性更改状态时，将引发此事件。
IsSupportedChanged	在检测到或删除亮度可控制显示器时发生。 当 IsSupported 属性更改时，将引发此事件。