BrightnessOverride.GetForCurrentView Método

Definição

Namespace:

Windows.Graphics.Display

Retorna um objeto BrightnessOverride . Esse método requer CoreWindow, portanto, ele pode ser usado apenas por aplicativos que estão sendo executados atualmente em uma janela. O objeto de substituição de brilho retornado pode não ser o mesmo entre várias chamadas para BrightnessOverride.GetForCurrentView no mesmo thread.

Você deve chamar BrightnessOverride.GetForCurrentView do thread de interface do usuário do main.

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

Retornos

BrightnessOverride

O brilho substitui o objeto .

Exemplos

Este exemplo mostra como os aplicativos executados em uma janela podem substituir o brilho do dispositivo com brilho total. Para interromper o processo de substituição, use 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();
}

Comentários

Esse método gerará uma exceção de acesso negado se não houver CoreWindow no thread de chamada.

Se você chamar o método StartOverride em várias instâncias sucessivas, a substituição pelo valor de brilho mais alto terá precedência sobre chamadas subsequentes em instâncias com valores mais baixos. Para evitar problemas, armazene em cache a instância recuperada de BrightnessOverride.GetForCurrentView e reutilize essa instância ou sempre chame StopOverride no BrightnessOverride aplicado anteriormente.