Freigeben über


BrightnessOverride Klasse

Definition

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

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.

Gilt für: