FrameworkElement.Style Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

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

Style

Die angewendete Formatvorlage für das Objekt, sofern vorhanden; nullandernfalls . Der Standardwert für ein standardmäßig erstelltes FrameworkElement ist null.

Hinweise

Das direkte Festlegen der Style Eigenschaft ist nicht die gängigste 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 FrameworkElement.Style wird durch einen lokalen Eigenschaftswert überschrieben, sodass das Festlegen des lokalen Werts direkter und vorhersagbarer 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. Diese Formatvorlage wird in der Regel mithilfe des impliziten Stilfeatures angewendet, nicht durch Festlegen Stylevon . 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 häufig den Steuerelementstil zur Laufzeit zurück, als Reaktion auf Änderungen in Zuständen, die sich für die Benutzer visuell manifestieren. Beispielsweise verfügen Steuerelementvorlagen in der Regel über den Status "Fokussiert", der der Steuerelementdarstellung einen visuellen Fokusindikator hinzufügt, sodass ein Tastaturbenutzer sehen kann, welches Element in der Benutzeroberfläche den aktuellen Tastaturfokus aufweist. Weitere Informationen zum Konzept des visuellen Zustands finden Sie unter XAML-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 eine Formatvorlage festgelegt wurde. Oder Sie können setter zur Sammlung in Setters 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 überprüfen Style. Eine Formatvorlage gilt als verwendet, sobald ein geladenes Objekt auf sie verweist, das mit der Objektstruktur einer angezeigten Seite der Benutzeroberfläche verbunden ist. Ein Style und sein Setters können auch als versiegelt betrachtet werden, wenn das Objekt, das diese Formatvorlage verwendet, sein Loaded-Ereignis auslöst. Beim Versuch, eine einzelne Eigenschaft eines in der Verwendung verwendeten Stils (z. B. eine Eigenschaft in der Setters Auflistung) zu ändern, wird eine Ausnahme ausgelöst.

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

Wenn sie zur Laufzeit abgefragt wird, gibt die Style Eigenschaft keine Formatvorlagen zurück, die von einer angewendeten Vorlage oder aktiven visuellen Zuständen stammen. Sie gibt nur Stile zurück, die explizit von der Style -Eigenschaft festgelegt wurden. Darüber hinaus werden keine impliziten Stile zurückgegeben.