BrightnessOverride.GetForCurrentView 方法

定義

命名空間:

Windows.Graphics.Display

會傳回 BrightnessOverride 物件。 這個方法需要 CoreWindow，因此它只能由目前在視窗中執行的應用程式使用。 在相同執行緒上多次呼叫 BrightnessOverride.GetForCurrentView 之間，傳回的亮度覆寫物件可能不相同。

您必須從主要 UI 執行緒呼叫 BrightnessOverride.GetForCurrentView 。

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

傳回

BrightnessOverride

亮度覆寫物件。

範例

此範例示範在視窗中執行的應用程式如何以完整亮度覆寫裝置的亮度。 若要停止覆寫程式，請使用 StopOverride。

private void Set_Full_Brightness()
{
    //Create BrightnessOverride object
    BrightnessOverride bo = BrightnessOverride.GetForCurrentView();

    //Set override brightness to full brightness even when battery is low
    bo.SetBrightnessScenario(DisplayBrightnessScenario.FullBrightness, DisplayBrightnessOverrideOptions.None);

    //Request to start the overriding process
    bo.StartOverride();
}

備註

如果呼叫執行緒上沒有 CoreWindow ，這個方法會擲回拒絕存取的例外狀況。

如果您在多個實例上連續呼叫 StartOverride 方法，則具有最高 亮度 值的覆寫會優先于具有較低值之實例的後續呼叫。 若要避免問題，請快取從BrightnessOverride.GetForCurrentView擷取的實例，並重複使用該實例，或一律在先前套用的 BrightnessOverride 上呼叫 StopOverride。