BrightnessOverride.GetForCurrentView メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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戻り値
明るさオーバーライド オブジェクト。
例
この例では、ウィンドウで実行されるアプリが、完全な明るさでデバイスの明るさをオーバーライドする方法を示します。 オーバーライドするプロセスを停止するには、 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 を常に呼び出します。