BrightnessOverride.GetForCurrentView Methode

Definition

Namespace:

Windows.Graphics.Display

Gibt ein BrightnessOverride-Objekt zurück. Diese Methode erfordert CoreWindow, sodass sie nur von Apps verwendet werden kann, die derzeit in einem Fenster ausgeführt werden. Das zurückgegebene Helligkeitsüberschreibungsobjekt ist möglicherweise nicht zwischen mehreren Aufrufen von BrightnessOverride.GetForCurrentView im selben Thread identisch.

Sie müssen BrightnessOverride.GetForCurrentView über den Standard UI-Thread aufrufen.

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

Gibt zurück

BrightnessOverride

Das Helligkeits-Überschreiben des Objekts.

Beispiele

In diesem Beispiel wird gezeigt, wie Apps, die in einem Fenster ausgeführt werden, die Helligkeit des Geräts bei voller Helligkeit außer Kraft setzen können. Verwenden Sie StopOverride, um den Überschreibungsprozess zu beenden.

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();
}

Hinweise

Diese Methode löst eine Zugriffsverweigerungs-Ausnahme aus, wenn im aufrufenden Thread kein CoreWindow vorhanden ist.

Wenn Sie die StartOverride-Methode für mehrere Instanzen hintereinander aufrufen, hat die Überschreibung mit dem höchsten Helligkeitswert Vorrang vor nachfolgenden Aufrufen von Instanzen mit niedrigeren Werten. Um Probleme zu vermeiden, zwischenspeichern Sie die von BrightnessOverride.GetForCurrentView abgerufene instance, und verwenden Sie diese instance wieder, oder rufen Sie immer StopOverride für die zuvor angewendete BrightnessOverride auf.