FrameworkElement.RequestedTheme Eigenschaft

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

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 AngeforderteTheme 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

ElementTheme

Ein Wert der Enumeration, z. B. Light.

Hinweise

Das Ändern des RequestedTheme-Werts ändert effektiv das Verhalten der Ressourcensuche 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 jedes 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 überschrieben werden, indem RequestedTheme erneut explizit festgelegt wird. In diesem XAML-Beispiel legt das übergeordnete StackPanel beispielsweise das Design auf Light fest, und dieser Wert erbt an das erste untergeordnete TextBlock-Element , aber nicht an den zweiten TextBlock , da er stattdessen den Wert auf Dunkel festlegt.

<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. Auf Windows Phone führt die Verwendung des Werts ElementTheme.Default zu einer Abfrage für das Systemdesign, wie vom Benutzer festgelegt.

Gilt für:

Weitere Informationen