BrightnessOverride Classe

Définition

Espace de noms:

Windows.Graphics.Display

BrightnessOverride permet à votre application de remplacer le niveau de luminosité de l’écran défini pour l’appareil. Avec cette API, vous pouvez avoir des contrôles de luminosité par application sur les appareils qui prennent en charge la luminosité contrôlable.

Vous pouvez utiliser BrightnessOverride pour remplacer le paramètre de niveau de luminosité de l’utilisateur de manière temporaire ou permanente.

Notes

Lorsque vous récupérez pour la première fois un objet BrightnessOverride initialisé à partir de GetDefaultForSystem ou de GetForCurrentView, la valeur de la propriété BrightnessLevel de cet objet n’est pas définie (la valeur ne représente pas, par exemple, le niveau de luminosité système actuel). Vous devez d’abord appeler SetBrightnessLevel pour définir un niveau de 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

Héritage

Object Platform::Object IInspectable BrightnessOverride

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)

Propriétés

BrightnessLevel	Obtient le niveau de luminosité de l’écran pour cette instance BrightnessOverride (si vous avez précédemment appelé SetBrightnessLevel pour définir le niveau de luminosité). Notes Lorsque vous récupérez pour la première fois un objet BrightnessOverride initialisé à partir de GetDefaultForSystem ou de GetForCurrentView, la valeur de la propriété BrightnessLevel de cet objet n’est pas définie (la valeur ne représente pas, par exemple, le niveau de luminosité système actuel). Vous devez d’abord appeler SetBrightnessLevel pour définir un niveau de luminosité.
IsOverrideActive	Valeur BOOLEAN qui indique si le remplacement de la luminosité est actif. Si la valeur est TRUE, le niveau de luminosité actuel correspond au niveau de luminosité de remplacement. Cette valeur de propriété est toujours FALSE si StartOverride() n’est pas appelé.
IsSupported	Indique si l’appareil dispose actuellement d’au moins un affichage de luminosité contrôlable. Si la valeur est TRUE, l’appareil dispose d’au moins un écran de luminosité contrôlable qui prend en charge le remplacement de la luminosité.

Méthodes

GetDefaultForSystem()	Retourne un objet de remplacement de luminosité. Cette méthode ne nécessite pas CoreWindow . Elle peut donc être utilisée par les applications qui s’exécutent en arrière-plan.
GetForCurrentView()	Renvoie un objet BrightnessOverride . Cette méthode nécessite CoreWindow. Elle peut donc être utilisée uniquement par les applications qui s’exécutent actuellement dans une fenêtre. L’objet de remplacement de luminosité retourné peut ne pas être identique entre plusieurs appels à BrightnessOverride.GetForCurrentView sur le même thread. Vous devez appeler BrightnessOverride.GetForCurrentView à partir du thread d’interface utilisateur main.
GetLevelForScenario(DisplayBrightnessScenario)	Obtient le niveau de luminosité associé au scénario spécifié.
SaveForSystemAsync(BrightnessOverride)	Enregistre les paramètres de remplacement de luminosité spécifiés en validant ces valeurs dans les paramètres utilisateur. Utilisez cette méthode pour conserver les paramètres de remplacement après les arrêts de substitution. Si null est passé pour valeur, le système active la luminosité automatique.
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	Définit le niveau de luminosité et les options de remplacement. Lorsque votre application est prête à modifier la luminosité actuelle avec ce que vous souhaitez remplacer, appelez StartOverride.
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	Définit le niveau de luminosité, en spécifiant un scénario qui a un niveau de luminosité bien connu et les options de remplacement du remplacement de luminosité.
StartOverride()	Demande de commencer à remplacer le niveau de luminosité de l’écran. La demande de commencer à remplacer ne signifie pas que le niveau de luminosité de l’écran change toujours pour correspondre au niveau de luminosité de remplacement spécifié. C’est toujours au système de décider s’il faut ou non honorer cette demande de remplacement. Utilisez les propriétés IsOverrideActive et IsOverrideActiveChanged pour déterminer si le système a respecté la demande de remplacement.
StopOverride()	Cesse de remplacer le niveau de luminosité.

Événements

BrightnessLevelChanged	Se produit lorsque le niveau de luminosité de l’écran change.
IsOverrideActiveChanged	Se produit lorsque le niveau de luminosité de l’écran commence à correspondre ou s’arrête pour correspondre au niveau de luminosité de remplacement. Cet événement est déclenché lorsque la propriété IsOverrideActive change d’état.
IsSupportedChanged	Se produit lorsqu’un affichage contrôlable de la luminosité est détecté ou supprimé. Cet événement est déclenché lorsque la propriété IsSupported change .