BrightnessOverride.GetForCurrentView メソッド

定義

名前空間:

Windows.Graphics.Display

BrightnessOverride オブジェクトを返します。 このメソッドには CoreWindow が必要であるため、ウィンドウで現在実行されているアプリでのみ使用できます。 返される明るさオーバーライド オブジェクトは、同じスレッドで BrightnessOverride.GetForCurrentView を複数回呼び出す間に同じではない可能性があります。

メイン 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 を常に呼び出します。