BrightnessOverride Klasse

Definition

Namespace:

Windows.Graphics.Display

Mit BrightnessOverride kann Ihre Anwendung die für das Gerät festgelegte Helligkeitsstufe des Bildschirms überschreiben. Mit dieser API können Sie anwendungsspezifische Helligkeitssteuerelemente auf Geräten verwenden, die die steuerbare Helligkeit unterstützen.

Sie können BrightnessOverride verwenden, um die Einstellung der Helligkeitsstufe des Benutzers vorübergehend oder dauerhaft außer Kraft zu setzen.

Hinweis

Wenn Sie zum ersten Mal ein initialisiertes BrightnessOverride-Objekt aus GetDefaultForSystem oder aus GetForCurrentView abrufen, ist der Wert der BrightnessLevel-Eigenschaft dieses Objekts undefiniert (der Wert stellt z. B. nicht die aktuelle Systemhelligkeitsstufe dar). Sie müssen zuerst SetBrightnessLevel aufrufen, um eine Helligkeitsstufe festzulegen.

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

Vererbung

Object Platform::Object IInspectable BrightnessOverride

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Creators Update (eingeführt in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v4.0)

Eigenschaften

BrightnessLevel	Ruft die Bildschirmhelligkeitsstufe für diese BrightnessOverride-instance ab (wenn Sie zuvor SetBrightnessLevel aufgerufen haben, um die Helligkeitsstufe festzulegen). Hinweis Wenn Sie zum ersten Mal ein initialisiertes BrightnessOverride-Objekt aus GetDefaultForSystem oder aus GetForCurrentView abrufen, ist der Wert der BrightnessLevel-Eigenschaft dieses Objekts undefiniert (der Wert stellt z. B. nicht die aktuelle Systemhelligkeitsstufe dar). Sie müssen zuerst SetBrightnessLevel aufrufen, um eine Helligkeitsstufe festzulegen.
IsOverrideActive	BOOLEAN-Wert, der angibt, ob die Helligkeitsüberschreibung aktiv ist. Wenn TRUE, stimmt die aktuelle Helligkeitsstufe mit dem Überschreibungshelligkeitsgrad überein. Dieser Eigenschaftswert ist immer FALSE, wenn StartOverride() nicht aufgerufen wird.
IsSupported	Gibt an, ob das Gerät derzeit über mindestens eine steuerbare Helligkeitsanzeige verfügt. Wenn TRUE, verfügt das Gerät über mindestens eine steuerbare Helligkeitsanzeige, die die Helligkeitsüberschreibung unterstützt.

Methoden

GetDefaultForSystem()	Gibt ein Helligkeitsüberschreibungsobjekt zurück. Diese Methode erfordert kein CoreWindow , sodass sie von Apps verwendet werden kann, die im Hintergrund ausgeführt werden.
GetForCurrentView()	Gibt ein BrightnessOverride-Objekt zurück. Diese Methode erfordert CoreWindow, sodass sie nur von Apps verwendet werden kann, die derzeit in einem Fenster ausgeführt werden. Das zurückgegebene Helligkeitsüberschreibungsobjekt ist möglicherweise nicht identisch zwischen mehreren Aufrufen von BrightnessOverride.GetForCurrentView im selben Thread. Sie müssen BrightnessOverride.GetForCurrentView aus dem Standard UI-Thread aufrufen.
GetLevelForScenario(DisplayBrightnessScenario)	Ruft die dem angegebenen Szenario zugeordnete Helligkeitsstufe ab.
SaveForSystemAsync(BrightnessOverride)	Speichert die angegebenen Helligkeitsüberschreibungseinstellungen, indem diese Werte in Benutzereinstellungen committen. Verwenden Sie diese Methode, um die Außerkraftsetzungseinstellungen nach dem Überschreiben von Stopps beizubehalten. Wenn null für value übergeben wird, aktiviert das System die automatische Helligkeit.
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	Legt die Helligkeitsstufe und die Außerkraftsetzungsoptionen fest. Wenn Ihre App bereit ist, die aktuelle Helligkeit mit dem zu ändern, mit dem Sie sie überschreiben möchten, rufen Sie StartOverride auf.
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	Legt die Helligkeitsstufe fest, indem ein Szenario mit einer bekannten Helligkeitsstufe und die Außerkraftsetzungsoptionen der Helligkeitsüberschreibung angegeben werden.
StartOverride()	Anforderung, um mit dem Überschreiben der Bildschirmhelligkeit zu beginnen. Die Anforderung, mit der Überschreibung zu beginnen, bedeutet nicht, dass sich die Bildschirmhelligkeit immer an die angegebene Überschreibungshelligkeitsstufe ändert. Es liegt weiterhin am System, zu entscheiden, ob diese Überschreibungsanforderung berücksichtigt werden soll. Verwenden Sie die Eigenschaften IsOverrideActive und IsOverrideActiveChanged , um zu bestimmen, ob das System die Überschreibungsanforderung berücksichtigt hat.
StopOverride()	Beendet das Überschreiben der Helligkeitsstufe.

Ereignisse

BrightnessLevelChanged	Tritt auf, wenn sich die Bildschirmhelligkeit ändert.
IsOverrideActiveChanged	Tritt auf, wenn die Bildschirmhelligkeitsstufe entweder mit dem Überschreiben der Helligkeitsstufe übereinstimmt oder beendet wird. Dieses Ereignis wird ausgelöst, wenn die IsOverrideActive-Eigenschaft den Zustand ändert.
IsSupportedChanged	Tritt auf, wenn eine helligkeitskontrollierbare Anzeige erkannt oder entfernt wird. Dieses Ereignis wird ausgelöst, wenn sich die IsSupported-Eigenschaft ändert.