BrightnessOverride Kelas

Definisi

Ruang nama:

Windows.Graphics.Display

BrightnessOverride memungkinkan aplikasi Anda untuk mengambil alih tingkat kecerahan layar yang diatur untuk perangkat. Dengan API ini, Anda dapat memiliki kontrol kecerahan per aplikasi pada perangkat yang mendukung kecerahan yang dapat dikontrol.

Anda dapat menggunakan BrightnessOverride untuk mengambil alih pengaturan tingkat kecerahan pengguna baik untuk sementara atau permanen.

Catatan

Ketika Anda pertama kali mengambil objek BrightnessOverride yang diinisialisasi dari GetDefaultForSystem atau dari GetForCurrentView, nilai properti BrightnessLevel objek tersebut tidak terdefinisi (nilainya tidak, misalnya, mewakili tingkat kecerahan sistem saat ini). Anda harus terlebih dahulu memanggil SetBrightnessLevel untuk mengatur tingkat kecerahan.

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

Warisan

Object Platform::Object IInspectable BrightnessOverride

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Properti

BrightnessLevel	Mendapatkan tingkat kecerahan layar untuk instans BrightnessOverride ini (jika sebelumnya Anda telah memanggil SetBrightnessLevel untuk mengatur tingkat kecerahan). Catatan Ketika Anda pertama kali mengambil objek BrightnessOverride yang diinisialisasi dari GetDefaultForSystem atau dari GetForCurrentView, nilai properti BrightnessLevel objek tersebut tidak terdefinisi (nilainya tidak, misalnya, mewakili tingkat kecerahan sistem saat ini). Anda harus terlebih dahulu memanggil SetBrightnessLevel untuk mengatur tingkat kecerahan.
IsOverrideActive	Nilai BOOLEAN yang menunjukkan apakah penimpaan kecerahan aktif. Jika TRUE, tingkat kecerahan saat ini cocok dengan tingkat kecerahan penimpaan. Nilai properti ini akan selalu FALSE jika StartOverride() tidak dipanggil.
IsSupported	Menunjukkan apakah perangkat saat ini memiliki setidaknya satu tampilan yang dapat dikontrol kecerahan. Jika TRUE, perangkat memiliki setidaknya satu tampilan yang dapat dikontrol kecerahan yang mendukung penimpaan kecerahan.

Metode

GetDefaultForSystem()	Mengembalikan objek penimpaan kecerahan. Metode ini tidak memerlukan CoreWindow sehingga dapat digunakan oleh aplikasi yang berjalan di latar belakang.
GetForCurrentView()	Mengembalikan objek BrightnessOverride . Metode ini memerlukan CoreWindow, sehingga hanya dapat digunakan oleh aplikasi yang saat ini berjalan di jendela. Objek penimpaan 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.
GetLevelForScenario(DisplayBrightnessScenario)	Mendapatkan tingkat kecerahan yang terkait dengan skenario yang ditentukan.
SaveForSystemAsync(BrightnessOverride)	Menyimpan pengaturan penimpaan kecerahan yang ditentukan dengan menerapkan nilai-nilai ini ke pengaturan pengguna. Gunakan metode ini untuk mempertahankan pengaturan penimpaan setelah penimpaan berhenti. Jika null diteruskan untuk nilai, maka sistem mengaktifkan kecerahan otomatis.
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	Mengatur tingkat kecerahan dan opsi penimpaan. Saat aplikasi Anda siap untuk mengubah kecerahan saat ini dengan apa yang ingin Anda ambil alih, panggil StartOverride.
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	Mengatur tingkat kecerahan, dengan menentukan skenario yang memiliki tingkat kecerahan terkenal, dan opsi penimpaan penimpaan kecerahan.
StartOverride()	Minta untuk mulai mengesampingkan tingkat kecerahan layar. Permintaan untuk mulai mengambil alih tidak berarti bahwa tingkat kecerahan layar selalu berubah agar sesuai dengan tingkat kecerahan penimpaan yang ditentukan. Masih terserah sistem untuk memutuskan apakah akan mematuhi permintaan penimpaan ini atau tidak. Gunakan properti IsOverrideActive dan IsOverrideActiveChanged untuk menentukan apakah sistem telah mematuhi permintaan penimpaan.
StopOverride()	Berhenti mengesampingkan tingkat kecerahan.

Acara

BrightnessLevelChanged	Terjadi ketika tingkat kecerahan layar berubah.
IsOverrideActiveChanged	Terjadi ketika tingkat kecerahan layar mulai cocok atau berhenti untuk mencocokkan tingkat kecerahan penimpaan. Kejadian ini dimunculkan ketika properti IsOverrideActive berubah status.
IsSupportedChanged	Terjadi ketika tampilan yang dapat dikontrol kecerahan terdeteksi atau dihapus. Kejadian ini dimunculkan ketika properti IsSupported berubah.