BrightnessOverride.GetForCurrentView Metodo

Definizione

Spazio dei nomi:

Windows.Graphics.Display

Restituisce un oggetto BrightnessOverride . Questo metodo richiede CoreWindow, quindi può essere usato solo dalle app attualmente in esecuzione in una finestra. L'oggetto di override della luminosità restituito potrebbe non essere lo stesso tra più chiamate a BrightnessOverride.GetForCurrentView nello stesso thread.

È necessario chiamare BrightnessOverride.GetForCurrentView dal thread principale dell'interfaccia utente.

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

Restituisce

BrightnessOverride

Oggetto di override della luminosità.

Esempio

Questo esempio mostra come le app eseguite in una finestra possono eseguire l'override della luminosità del dispositivo con luminosità completa. Per arrestare il processo di override, usare 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();
}

Commenti

Questo metodo genera un'eccezione di accesso negato se non è presente CoreWindow nel thread chiamante.

Se si chiama il metodo StartOverride su più istanze in successione, l'override con il valore di luminosità più alto avrà la precedenza sulle chiamate successive su istanze con valori inferiori. Per evitare problemi, memorizzare nella cache l'istanza recuperata da BrightnessOverride.GetForCurrentView e riutilizzarla oppure chiamare sempre StopOverride nell'oggetto BrightnessOverride applicato in precedenza.