BrightnessOverride.GetForCurrentView Metode

Definisi

Ruang nama:

Windows.Graphics.Display

Mengembalikan objek BrightnessOverride . Metode ini memerlukan CoreWindow, sehingga hanya dapat digunakan oleh aplikasi yang saat ini berjalan di jendela. Objek pengambilalihan kecerahan yang dikembalikan mungkin tidak sama antara beberapa panggilan ke BrightnessOverride.GetForCurrentView pada utas yang sama.

Anda harus memanggil BrightnessOverride.GetForCurrentView dari utas UI utama.

public:
 static BrightnessOverride ^ GetForCurrentView();

 static BrightnessOverride GetForCurrentView();

public static BrightnessOverride GetForCurrentView();

function getForCurrentView()

Public Shared Function GetForCurrentView () As BrightnessOverride

Mengembalikan

BrightnessOverride

Kecerahan mengesampingkan objek.

Contoh

Contoh ini menunjukkan bagaimana aplikasi yang berjalan di jendela dapat mengambil alih kecerahan perangkat pada kecerahan penuh. Untuk menghentikan proses penimpaan, gunakan 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();
}

Keterangan

Metode ini melemparkan pengecualian akses ditolak jika tidak ada CoreWindow pada utas panggilan.

Jika Anda memanggil metode StartOverride pada beberapa instans secara berturut-turut, penimpaan dengan nilai kecerahan tertinggi akan lebih diutamakan daripada panggilan berikutnya pada instans dengan nilai yang lebih rendah. Untuk menghindari masalah, cache instans yang diambil dari BrightnessOverride.GetForCurrentView dan gunakan kembali instans tersebut, atau selalu panggil StopOverride pada BrightnessOverride yang diterapkan sebelumnya.