Share via


FrameworkElement.RequestedTheme Eigenschaft

Definition

Ruft das UI-Design ab, das vom UIElement (und seinen untergeordneten Elementen) für die Ressourcenbestimmung verwendet wird, oder legt es fest. Das UI-Design, das Sie mit RequestedTheme angeben, kann die RequestedTheme auf App-Ebene überschreiben.

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.

Hinweis

Unter Windows führt das Festlegen von RequestedTheme auf ElementTheme.Default immer dazu, dass "Dunkel" das Design ist.

Gilt für:

Weitere Informationen