FrameworkElement.RequestedTheme Properti
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.
Mendapatkan atau mengatur tema UI yang digunakan oleh UIElement (dan elemen turunannya ) untuk penentuan sumber daya. Tema UI yang Anda tentukan dengan RequestedTheme dapat mengganti requestedTheme tingkat aplikasi.
public:
property ElementTheme RequestedTheme { ElementTheme get(); void set(ElementTheme value); };
ElementTheme RequestedTheme();
void RequestedTheme(ElementTheme value);
public ElementTheme RequestedTheme { get; set; }
var elementTheme = frameworkElement.requestedTheme;
frameworkElement.requestedTheme = elementTheme;
Public Property RequestedTheme As ElementTheme
<uiElement RequestedTheme="elementThemeMemberName" .../>
Nilai Properti
Nilai enumerasi, misalnya Cahaya.
Keterangan
Mengubah nilai RequestedTheme secara efektif mengubah perilaku pencarian sumber daya untuk templat default elemen. Jika Anda mengubah nilai menjadi Terang , maka templat menggunakan nilai dari ResourceDictionary yang dikuntangani sebagai "Terang" dalam koleksi ThemeDictionaries . Mengatur tema UI secara berbeda dari tema aplikasi sering kali sesuai untuk kontrol mengambang seperti menu dan flyout.
Anda dapat mengubah nilai properti RequestedTheme untuk elemen tertentu pada run-time. Itu berbeda dengan properti Application.RequestedTheme , yang melempar pengecualian jika Anda mencoba mengaturnya saat aplikasi berjalan.
Nilai RequestedTheme yang Anda tetapkan pada FrameworkElement akan mewarisi ke elemen apa pun yang ditumpuk dalam elemen tempat RequestedTheme diatur, tetapi pewarisan tersebut dapat ditimpa dengan secara eksplisit mengatur RequestedTheme lagi. Misalnya, dalam contoh XAML ini, StackPanel induk mengatur tema ke Terang, dan nilai tersebut mewarisi ke elemen turunan TextBlock pertama, tetapi tidak ke TextBlock kedua karena mengatur nilai menjadi Gelap sebagai gantinya.
<StackPanel RequestedTheme="Light">
<TextBlock>Text using light theme.</TextBlock>
<TextBlock RequestedTheme="Dark">Text using dark theme.</TextBlock>
</StackPanel>
Properti RequestedTheme diabaikan jika pengguna berjalan dalam mode kontras tinggi. Lihat Tema kontras tinggi dan sampel gaya kontras tinggi XAML.
Catatan
Di Windows, mengatur RequestedTheme ke ElementTheme.Default akan selalu mengakibatkan "Gelap" menjadi tema. Di Windows Phone, menggunakan nilai ElementTheme.Default akan menghasilkan kueri untuk tema sistem, seperti yang diatur oleh pengguna.