FrameworkElement.RequestedTheme Eigenschaft

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" .../>

Eigenschaftswert

Ein Wert der -Enumeration, z. B Light. .

Hinweise

Wenn Sie den RequestedTheme Wert ändern, ändert sich das Ressourcensuchverhalten für die Standardvorlage des Elements. Wenn Sie den Wert in Light ändern, verwendet die Vorlage die Werte aus resourceDictionary , die in der ThemeDictionaries-Auflistung als "Light" gekennzeichnet sind. Das Festlegen des UI-Designs vom Design der App ist häufig für unverankerte Steuerelemente wie Menüs und Flyouts geeignet.

Sie können den Wert der RequestedTheme -Eigenschaft für ein beliebiges Element zur Laufzeit ändern. Dies steht im Gegensatz zur Application.RequestedTheme-Eigenschaft , die eine Ausnahme auslöst, wenn Sie versuchen, sie während der Ausführung der App festzulegen.

Der RequestedTheme Wert, den Sie für ein FrameworkElement festlegen, erbt an alle Elemente, die innerhalb des Elements geschachtelt sind, in dem RequestedTheme festgelegt ist, aber diese Vererbung kann durch explizites Erneutes Festlegen RequestedTheme überschrieben werden. In diesem XAML-Beispiel legt das übergeordnete StackPanel beispielsweise das Design auf Lightfest, und dieser Wert erbt an das erste untergeordnete TextBlock-Element , aber nicht an das zweite TextBlock Element, da der Wert stattdessen auf Dark festgelegt wird.

<StackPanel RequestedTheme="Light">
  <TextBlock>Text using light theme.</TextBlock>
  <TextBlock RequestedTheme="Dark">Text using dark theme.</TextBlock>
</StackPanel>

Die RequestedTheme -Eigenschaft wird ignoriert, wenn der Benutzer im Modus mit hohem Kontrast ausgeführt wird. Weitere Informationen finden Sie unter Designs mit hohem Kontrast undXAML-Formatvorlage für hohen Kontrast.

Gilt für:

Weitere Informationen

• RequestedTheme
• Beispiel für xaml angefordertes Design
• {ThemeResource}-Markuperweiterung