BrightnessOverride.GetForCurrentView Método

Definición

Espacio de nombres:

Windows.Graphics.Display

Devuelve un objeto BrightnessOverride . Este método requiere CoreWindow, por lo que solo se pueden usar en aplicaciones que se ejecutan actualmente en una ventana. Es posible que el objeto de invalidación de brillo devuelto no sea el mismo entre varias llamadas a BrightnessOverride.GetForCurrentView en el mismo subproceso.

Debes llamar a BrightnessOverride.GetForCurrentView desde el subproceso principal de la interfaz de usuario.

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

Devoluciones

BrightnessOverride

Objeto de invalidación de brillo.

Ejemplos

En este ejemplo se muestra cómo las aplicaciones que se ejecutan en una ventana pueden invalidar el brillo del dispositivo con un brillo completo. Para detener el proceso de invalidación, 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();
}

Comentarios

Este método produce una excepción de acceso denegado si no hay CoreWindow en el subproceso que realiza la llamada.

Si llama al método StartOverride en varias instancias en sucesión, la invalidación con el valor de brillo más alto tendrá prioridad sobre las llamadas posteriores en instancias con valores inferiores. Para evitar problemas, almacene en caché la instancia recuperada de BrightnessOverride.GetForCurrentView y reutilice esa instancia, o bien llame siempre a StopOverride en el BrightnessOverride aplicado anteriormente.