BrightnessOverride Clase

Definición

Espacio de nombres:

Windows.Graphics.Display

BrightnessOverride permite a la aplicación invalidar el nivel de brillo de la pantalla establecido para el dispositivo. Con esta API, puede tener controles de brillo por aplicación en dispositivos que admitan el brillo controlable.

Puedes usar BrightnessOverride para invalidar la configuración del nivel de brillo del usuario de forma temporal o permanente.

Nota

Cuando recupera por primera vez un objeto BrightnessOverride inicializado de GetDefaultForSystem o de GetForCurrentView, el valor de la propiedad BrightnessLevel de ese objeto no está definido (el valor no representa, por ejemplo, el nivel de brillo actual del sistema). Primero debe llamar a SetBrightnessLevel para establecer un nivel de brillo.

public ref class BrightnessOverride sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BrightnessOverride final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BrightnessOverride

Public NotInheritable Class BrightnessOverride

Herencia

Object Platform::Object IInspectable BrightnessOverride

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Propiedades

BrightnessLevel	Obtiene el nivel de brillo de la pantalla para esta instancia de BrightnessOverride (si anteriormente ha llamado a SetBrightnessLevel para establecer el nivel de brillo). Nota Cuando recupera por primera vez un objeto BrightnessOverride inicializado de GetDefaultForSystem o de GetForCurrentView, el valor de la propiedad BrightnessLevel de ese objeto no está definido (el valor no representa, por ejemplo, el nivel de brillo actual del sistema). Primero debe llamar a SetBrightnessLevel para establecer un nivel de brillo.
IsOverrideActive	Valor BOOLEAN que indica si la invalidación de brillo está activa. Si es TRUE, el nivel de brillo actual coincide con el nivel de brillo de invalidación. Este valor de propiedad siempre será FALSE si no se llama a StartOverride().
IsSupported	Indica si el dispositivo tiene actualmente al menos una pantalla controlable de brillo. Si es TRUE, el dispositivo tiene al menos una pantalla controlable de brillo que admite la invalidación de brillo.

Métodos

GetDefaultForSystem()	Devuelve un objeto de invalidación de brillo. Este método no requiere CoreWindow para que las aplicaciones que se ejecuten en segundo plano puedan usarlas.
GetForCurrentView()	Devuelve un objeto BrightnessOverride . Este método requiere CoreWindow, por lo que solo las aplicaciones que se ejecutan actualmente en una ventana pueden usarlas. 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. Debe llamar a BrightnessOverride.GetForCurrentView desde el subproceso principal de la interfaz de usuario.
GetLevelForScenario(DisplayBrightnessScenario)	Obtiene el nivel de brillo asociado al escenario especificado.
SaveForSystemAsync(BrightnessOverride)	Guarda la configuración de invalidación de brillo especificada confirmando estos valores en la configuración del usuario. Use este método para conservar la configuración de invalidación después de que se detenga la invalidación. Si null se pasa por valor, el sistema activa el brillo automático.
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	Establece el nivel de brillo y las opciones de invalidación. Cuando la aplicación esté lista para cambiar el brillo actual con lo que desea invalidar con, llame a StartOverride.
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	Establece el nivel de brillo, especificando un escenario que tiene un nivel de brillo conocido y las opciones de invalidación de la invalidación de brillo.
StartOverride()	Solicitud para empezar a invalidar el nivel de brillo de la pantalla. La solicitud para empezar a invalidar no significa que el nivel de brillo de la pantalla cambie siempre para que coincida con el nivel de brillo de invalidación especificado. Todavía está en el sistema para decidir si se debe respetar o no esta solicitud de invalidación. Use las propiedades IsOverrideActive y IsOverrideActiveChanged para determinar si el sistema ha cumplido la solicitud de invalidación.
StopOverride()	Detiene la invalidación del nivel de brillo.

Eventos

BrightnessLevelChanged	Se produce cuando cambia el nivel de brillo de la pantalla.
IsOverrideActiveChanged	Se produce cuando el nivel de brillo de la pantalla empieza a coincidir o se detiene para que coincida con el nivel de brillo de invalidación. Este evento se genera cuando cambia el estado de la propiedad IsOverrideActive .
IsSupportedChanged	Se produce cuando se detecta o quita una pantalla controlable de brillo. Este evento se genera cuando cambia la propiedad IsSupported .