BrightnessOverride.GetForCurrentView 方法

定义

返回 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

返回

亮度替代对象。

示例

此示例演示在窗口中运行的应用如何以全亮度覆盖设备的亮度。 若要停止重写进程,请使用 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

适用于