Compartilhar via


BrightnessOverride Classe

Definição

BrightnessOverride permite que seu aplicativo substitua o nível de brilho da tela definido para o dispositivo. Com essa API, você pode ter controles de brilho por aplicativo em dispositivos que dão suporte ao brilho controlável.

Você pode usar BrightnessOverride para substituir a configuração de nível de brilho do usuário temporariamente ou permanentemente.

Observação

Quando você recupera pela primeira vez um objeto BrightnessOverride inicializado de GetDefaultForSystem ou de GetForCurrentView, o valor da propriedade BrightnessLevel desse objeto é indefinido (o valor não representa, por exemplo, o nível de brilho atual do sistema). Primeiro, você precisa chamar SetBrightnessLevel para definir um nível de brilho.

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
Herança
Object Platform::Object IInspectable BrightnessOverride
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Propriedades

BrightnessLevel

Obtém o nível de brilho da tela para essa instância brightnessOverride (se você já chamou SetBrightnessLevel para definir o nível de brilho).

Observação

Quando você recupera pela primeira vez um objeto BrightnessOverride inicializado de GetDefaultForSystem ou de GetForCurrentView, o valor da propriedade BrightnessLevel desse objeto é indefinido (o valor não representa, por exemplo, o nível de brilho atual do sistema). Primeiro, você precisa chamar SetBrightnessLevel para definir um nível de brilho.

IsOverrideActive

Valor BOOLEAN que indica se a substituição de brilho está ativa. Se TRUE, o nível de brilho atual corresponderá ao nível de brilho de substituição. Esse valor de propriedade sempre será FALSE se StartOverride() não for chamado.

IsSupported

Indica se o dispositivo atualmente tem pelo menos uma tela controlável de brilho. Se TRUE, o dispositivo terá pelo menos uma tela controlável de brilho que dá suporte à substituição de brilho.

Métodos

GetDefaultForSystem()

Retorna um objeto de substituição de brilho. Esse método não requer CoreWindow para que possa ser usado por aplicativos em execução em segundo plano.

GetForCurrentView()

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.

GetLevelForScenario(DisplayBrightnessScenario)

Obtém o nível de brilho associado ao cenário especificado.

SaveForSystemAsync(BrightnessOverride)

Salva as configurações de substituição de brilho especificadas confirmando esses valores nas configurações do usuário. Use esse método para persistir as configurações de substituição depois que a substituição for interrompida. Se null for passado para valor, o sistema ativa o brilho automático.

SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)

Define o nível de brilho e as opções de substituição. Quando seu aplicativo estiver pronto para alterar o brilho atual com o que você deseja substituí-lo, chame StartOverride.

SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)

Define o nível de brilho especificando um cenário que tem um nível de brilho conhecido e as opções de substituição da substituição do brilho.

StartOverride()

Solicitação para começar a substituir o nível de brilho da tela. A solicitação para iniciar a substituição não significa que o nível de brilho da tela sempre muda para corresponder ao nível de brilho de substituição especificado. Ainda cabe ao sistema decidir se deve ou não cumprir essa solicitação de substituição. Use as propriedades IsOverrideActive e IsOverrideActiveChanged para determinar se o sistema respeitou a solicitação de substituição.

StopOverride()

Para de substituir o nível de brilho.

Eventos

BrightnessLevelChanged

Ocorre quando o nível de brilho da tela é alterado.

IsOverrideActiveChanged

Ocorre quando o nível de brilho da tela começa a corresponder ou para para corresponder ao nível de brilho de substituição. Esse evento é gerado quando a propriedade IsOverrideActive altera o estado.

IsSupportedChanged

Ocorre quando uma exibição controlável de brilho é detectada ou removida. Esse evento é gerado quando a propriedade IsSupported é alterada.

Aplica-se a