BrightnessOverride 類別

定義

命名空間:

Windows.Graphics.Display

BrightnessOverride 可讓您的應用程式覆寫為裝置設定的螢幕亮度等級。 透過此 API，您可以在支援可控制亮度的裝置上擁有每個應用程式亮度控制項。

您可以使用 BrightnessOverride 來暫時或永久覆寫使用者的亮度等級設定。

注意

當您第一次從GetDefaultForSystem或GetForCurrentView擷取初始化的BrightnessOverride物件時，該物件的BrightnessLevel屬性值未定義 (，例如，值不會定義，例如，表示目前的系統亮度等級) 。 您必須先呼叫 SetBrightnessLevel 來設定亮度等級。

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

繼承

Object Platform::Object IInspectable BrightnessOverride

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Creators Update (已於 10.0.15063.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v4.0 引進)

屬性

BrightnessLevel	如果您先前呼叫SetBrightnessLevel來設定亮度等級，則取得此BrightnessOverride實例的螢幕亮度等級) (。 注意 當您第一次從GetDefaultForSystem或GetForCurrentView擷取初始化的BrightnessOverride物件時，該物件的BrightnessLevel屬性值未定義 (，例如，值不會定義，例如，表示目前的系統亮度等級) 。 您必須先呼叫 SetBrightnessLevel 來設定亮度等級。
IsOverrideActive	BOOLEAN 值，指出亮度覆寫是否為使用中。 如果為 TRUE，則目前的亮度等級符合覆寫亮度等級。 如果未呼叫 StartOverride () ，這個屬性值一律為 FALSE。
IsSupported	指出裝置目前是否至少有一個亮度可控制顯示器。 如果為 TRUE，則裝置至少有一個支援亮度覆寫的亮度控制顯示器。

方法

GetDefaultForSystem()	傳回亮度覆寫物件。 此方法不需要 CoreWindow ，因此可供背景中執行的應用程式使用。
GetForCurrentView()	會傳回 BrightnessOverride 物件。 此方法需要 CoreWindow，因此它只能供目前在視窗中執行的應用程式使用。 在相同執行緒上對 BrightnessOverride.GetForCurrentView 的多個呼叫之間，傳回的亮度覆寫物件可能不相同。 您必須從主要 UI 執行緒呼叫 BrightnessOverride.GetForCurrentView 。
GetLevelForScenario(DisplayBrightnessScenario)	取得與指定案例相關聯的亮度等級。
SaveForSystemAsync(BrightnessOverride)	藉由將這些值認可至使用者設定，以儲存指定的亮度覆寫設定。 使用這個方法，在覆寫停止之後保存覆寫設定。 如果 null 已針對 值傳遞，則系統會開啟自動亮度。
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	設定亮度等級和覆寫選項。 當您的應用程式準備好以您想要覆寫的模式變更目前的亮度時，請呼叫 StartOverride。
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	藉由指定具有已知亮度等級的案例，以及亮度覆寫的覆寫選項，來設定亮度等級。
StartOverride()	要求開始覆寫螢幕亮度等級。 開始覆寫的要求並不表示螢幕亮度等級一律會變更，以符合指定的覆寫亮度等級。 系統仍會決定是否要接受此覆寫要求。 使用 IsOverrideActive 和 IsOverrideActiveChanged 屬性來判斷系統是否接受覆寫要求。
StopOverride()	停止覆寫亮度等級。

事件

BrightnessLevelChanged	發生于螢幕亮度等級變更時。
IsOverrideActiveChanged	當螢幕亮度等級開始比對或停止以符合覆寫亮度等級時發生。 當 IsOverrideActive屬性變更狀態時，就會引發此事件。
IsSupportedChanged	發生于偵測或移除亮度可控制顯示器時。 當 IsSupported屬性變更時，就會引發此事件。