Condividi tramite


BrightnessOverride Classe

Definizione

BrightnessOverride consente all'applicazione di eseguire l'override del livello di luminosità dello schermo impostato per il dispositivo. Con questa API è possibile avere controlli di luminosità per applicazione nei dispositivi che supportano la luminosità controllabile.

È possibile usare BrightnessOverride per eseguire l'override dell'impostazione del livello di luminosità dell'utente temporaneamente o permanentemente.

Nota

Quando si recupera per la prima volta un oggetto BrightnessOverride inizializzato da GetDefaultForSystem o da GetForCurrentView, il valore della proprietà BrightnessLevel dell'oggetto non è definito (ad esempio, il valore non rappresenta il livello di luminosità di sistema corrente). Devi prima chiamare SetBrightnessLevel per impostare un livello di luminosità.

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
Ereditarietà
Object Platform::Object IInspectable BrightnessOverride
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)

Proprietà

BrightnessLevel

Ottiene il livello di luminosità dello schermo per questa istanza di BrightnessOverride (se in precedenza è stato chiamato SetBrightnessLevel per impostare il livello di luminosità).

Nota

Quando si recupera per la prima volta un oggetto BrightnessOverride inizializzato da GetDefaultForSystem o da GetForCurrentView, il valore della proprietà BrightnessLevel dell'oggetto non è definito (ad esempio, il valore non rappresenta il livello di luminosità di sistema corrente). Devi prima chiamare SetBrightnessLevel per impostare un livello di luminosità.

IsOverrideActive

Valore BOOLEAN che indica se l'override della luminosità è attivo. Se TRUE, il livello di luminosità corrente corrisponde al livello di luminosità di sostituzione. Questo valore della proprietà sarà sempre FALSE se StartOverride() non viene chiamato.

IsSupported

Indica se il dispositivo dispone attualmente di almeno un display controllabile della luminosità. Se TRUE, il dispositivo ha almeno uno schermo controllabile della luminosità che supporta l'override della luminosità.

Metodi

GetDefaultForSystem()

Restituisce un oggetto di override della luminosità. Questo metodo non richiede CoreWindow in modo che possa essere usato dalle app in esecuzione in background.

GetForCurrentView()

Restituisce un oggetto BrightnessOverride . Questo metodo richiede CoreWindow, quindi può essere usato solo dalle app attualmente in esecuzione in una finestra. L'oggetto di override della luminosità restituito potrebbe non essere lo stesso tra più chiamate a BrightnessOverride.GetForCurrentView nello stesso thread.

È necessario chiamare BrightnessOverride.GetForCurrentView dal thread principale dell'interfaccia utente.

GetLevelForScenario(DisplayBrightnessScenario)

Ottiene il livello di luminosità associato allo scenario specificato.

SaveForSystemAsync(BrightnessOverride)

Salva le impostazioni di override della luminosità specificate eseguendo il commit di questi valori nelle impostazioni utente. Utilizzare questo metodo per rendere persistenti le impostazioni di override dopo l'arresto dell'override. Se null viene passato per il valore, il sistema attiva la luminosità automatica.

SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)

Imposta il livello di luminosità e le opzioni di override. Quando l'app è pronta per modificare la luminosità corrente con quello con cui vuoi eseguirne l'override, chiama StartOverride.

SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)

Imposta il livello di luminosità specificando uno scenario con un livello di luminosità noto e le opzioni di override dell'override della luminosità.

StartOverride()

Richiedere di avviare l'override del livello di luminosità dello schermo. La richiesta di avvio dell'override non significa che il livello di luminosità dello schermo cambia sempre in modo che corrisponda al livello di luminosità di override specificato. Spetta comunque al sistema decidere se rispettare o meno questa richiesta di override. Utilizzare le proprietà IsOverrideActive e IsOverrideActiveChanged per determinare se il sistema ha rispettato la richiesta di override.

StopOverride()

Arresta l'override del livello di luminosità.

Eventi

BrightnessLevelChanged

Si verifica quando cambia il livello di luminosità dello schermo.

IsOverrideActiveChanged

Si verifica quando il livello di luminosità dello schermo inizia a corrispondere o si arresta in modo che corrisponda al livello di luminosità di override. Questo evento viene generato quando la proprietà IsOverrideActive cambia stato.

IsSupportedChanged

Si verifica quando viene rilevata o rimossa una visualizzazione controllabile della luminosità. Questo evento viene generato quando la proprietà IsSupported viene modificata .

Si applica a