BrightnessOverride Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
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 |
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. |