FrameworkElement.RequestedTheme Properti

Definisi

Ruang nama:

Windows.UI.Xaml

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

ElementTheme

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.

Lihat juga

• RequestedTheme
• Sampel tema yang diminta XAML
• Ekstensi markup {ThemeResource}