Freigeben über


FrameworkElement.Style Eigenschaft

Definition

Ruft einen instance Style ab, der während des Layouts und Renderings auf dieses Objekt angewendet wird, oder legt diesen fest.

public:
 property Style ^ Style { Style ^ get(); void set(Style ^ value); };
Style Style();

void Style(Style value);
public Style Style { get; set; }
var style = frameworkElement.style;
frameworkElement.style = style;
Public Property Style As Style
<frameworkElement Style="{StaticResource styleResourceKey}"/>

Eigenschaftswert

Die angewendete Formatvorlage für das Objekt, falls vorhanden; andernfalls NULL. Der Standardwert für ein standardmäßig konstruiertes FrameworkElement ist NULL.

Hinweise

Das direkte Festlegen der Style-Eigenschaft ist nicht die gebräuchlichste Möglichkeit, die Darstellung eines UI-Elements zu formatieren. Stattdessen beeinflussen Sie die Darstellung eines UI-Elements mithilfe einer der folgenden Techniken:

  • Sie legen häufig einzelne UI-Eigenschaften eines UI-Elements als Attribute in XAML fest. FrameworkElement.Style gilt nur für das aktuelle Element, und jeder Wert aus einem StyleFrameworkElement.Style wird durch einen lokalen Eigenschaftswert überschrieben, sodass das Festlegen des lokalen Werts direkter und besser vorhersagbar ist. Weitere Informationen zur Beziehung zwischen einem Style-Wert und einem lokalen Eigenschaftswert finden Sie unter Übersicht über Abhängigkeitseigenschaften.
  • Steuerelementautoren schreiben in der Regel ein Steuerelement, das vorlagenfähig ist, aber auch eine Standardvorlage enthält. Ihre App kann das Steuerelement verwenden und dessen Darstellung ändern, indem sie eine neue ControlTemplate bereitstellt, die Teil eines in Ressourcen definierten Stils ist. Dieser Stil wird in der Regel mithilfe des impliziten Stilfeatures angewendet, nicht durch Festlegen von Formatvorlage. Weitere Informationen finden Sie unter Formatieren von Steuerelementen.
  • Steuerelementautoren machen auch Eigenschaften verfügbar, die auf Teile eines Steuerelements verweisen, für die Stile oder Werte nur auf diesen Teil angewendet werden können, sodass Sie das Steuerelement nicht vollständig neu erstellen müssen. Hier legen Sie eine spezifischere Eigenschaft fest, nicht FrameworkElement.Style.
  • Das visuelle Zustandsmodell setzt den Steuerelementstil zur Laufzeit häufig zurück, als Reaktion auf Änderungen in Zuständen, die sich für die Benutzer visuell manifestieren. Beispielsweise weisen Steuerelementvorlagen in der Regel den Status "Fokussiert" auf, der der Darstellung des Steuerelements eine visuelle Fokusanzeige hinzufügt, sodass ein Tastaturbenutzer sehen kann, welches Element in der Benutzeroberfläche den aktuellen Tastaturfokus hat. Weitere Informationen zum Konzept des visuellen Zustands finden Sie unter Schnellstart: Steuerelementvorlagen.

Sie können die Werte einzelner Eigenschaften ändern, die innerhalb eines Stils festgelegt wurden. Beispielsweise können Sie die Template-Eigenschaft zur Laufzeit festlegen, auch wenn diese Eigenschaft durch einen Stil festgelegt wurde. Oder Sie können der Sammlung in Setters Setter hinzufügen. Sobald diese Formatvorlage jedoch von einem geladenen Objekt verwendet wird, sollte der Style als versiegelt betrachtet werden. Sie können diesen Zustand erkennen, indem Sie den Wert von IsSealed für den Stil überprüfen. Ein Stil gilt als verwendet, sobald ein geladenes Objekt darauf verweist, das mit der Objektstruktur einer angezeigten Seite der Benutzeroberfläche verbunden ist. Ein Style und seine Setter können auch als versiegelt betrachtet werden, wenn das Objekt, das diese Formatvorlage verwendet, sein Loaded-Ereignis auslöst. Der Versuch, eine einzelne Eigenschaft eines verwendeten Stils (z. B. eine Eigenschaft in der Setters-Auflistung ) zu ändern, löst eine Ausnahme aus.

Von Control abgeleitete Klassen verfügen über einen zusätzlichen Einstiegspunkt, der für die Steuerung von Autoren in Bezug auf Stil und Vorlagenanwendung nützlich ist. FrameworkElement definiert den virtuellen Rückruf OnApplyTemplate , der vor Loaded aufgerufen wird. Von Control abgeleitete Klassen können diesen Rückruf überschreiben, um die Eigenschaftswerte anzupassen, die von Vorlagen festgelegt wurden, bevor der Stil verwendet wird.

Wenn sie zur Laufzeit abgefragt wird, gibt die Style-Eigenschaft keine Stile zurück, die aus einer angewendeten Vorlage stammen, oder aktive visuelle Zustände. Es werden nur Stile zurückgegeben, die explizit von der Style-Eigenschaft festgelegt wurden. Darüber hinaus werden keine impliziten Stile zurückgegeben.

Gilt für: