BrightnessOverride.GetForCurrentView 方法

定义

命名空间:

Windows.Graphics.Display

返回 BrightnessOverride 对象。 此方法需要 CoreWindow，因此它只能由当前在窗口中运行的应用使用。 在同一线程上多次调用 BrightnessOverride.GetForCurrentView 时，返回的亮度替代对象可能不同。

必须从main UI 线程调用 BrightnessOverride.GetForCurrentView。

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

返回

BrightnessOverride

亮度替代对象。

示例

此示例演示在窗口中运行的应用如何以全亮度覆盖设备的亮度。 若要停止重写进程，请使用 StopOverride。

private void Set_Full_Brightness()
{
    //Create BrightnessOverride object
    BrightnessOverride bo = BrightnessOverride.GetForCurrentView();

    //Set override brightness to full brightness even when battery is low
    bo.SetBrightnessScenario(DisplayBrightnessScenario.FullBrightness, DisplayBrightnessOverrideOptions.None);

    //Request to start the overriding process
    bo.StartOverride();
}

注解

如果调用线程上没有 CoreWindow ，此方法将引发拒绝访问异常。

如果连续对多个实例调用 StartOverride 方法，则 具有最高亮度 值的替代将优先于具有较低值的实例的后续调用。 若要避免出现问题，请缓存从 BrightnessOverride.GetForCurrentView 检索到的实例并重复使用该实例，或始终在以前应用的 BrightnessOverride 上调用 StopOverride。