BrightnessOverride.GetForCurrentView Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 BrightnessOverrideGibt zurück
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.