Bagikan melalui


AutoSuggestBox.LightDismissOverlayMode Properti

Definisi

Mendapatkan atau menetapkan nilai yang menentukan apakah area di luar UI yang mematikan cahaya digelapkan.

public:
 property LightDismissOverlayMode LightDismissOverlayMode { LightDismissOverlayMode get(); void set(LightDismissOverlayMode value); };
LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);
public LightDismissOverlayMode LightDismissOverlayMode { get; set; }
var lightDismissOverlayMode = autoSuggestBox.lightDismissOverlayMode;
autoSuggestBox.lightDismissOverlayMode = lightDismissOverlayMode;
Public Property LightDismissOverlayMode As LightDismissOverlayMode

Nilai Properti

Nilai enumerasi yang menentukan apakah area di luar UI yang mematikan cahaya digelapkan. Defaultnya adalah Otomatis.

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

UI sementara, seperti panel saran AutoSuggestBox, ditutup saat Anda mengklik atau mengetuk di luarnya. Ini disebut pengalih cahaya. "Overlay" mengacu pada area di luar UI yang mematikan cahaya.

Secara default, "overlay" digelapkan di Xbox, dan tidak digelapkan di keluarga perangkat lain. Anda dapat mengatur LightDismissOverlayMode ke Aktif untuk membuat aplikasi Anda menggelapkan area "overlay" di semua keluarga perangkat, atau mengaturnya ke Nonaktif agar tidak menggelapkan area "overlay" di semua keluarga perangkat.

Kompatibilitas versi

Properti LightDismissOverlayMode tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AutoSuggestBox", "LightDismissOverlayMode"))
    {
        autoSuggestBox1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}

Berlaku untuk