FrameworkElement.Style Eigenschaft

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 am häufigsten verwendete Methode zum Formatieren der Darstellung eines UI-Elements. Stattdessen beeinflussen Sie die Darstellung eines UI-Elements durch eine 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 von einem lokalen Eigenschaftswert überschrieben, sodass das Festlegen des lokalen Werts direkter und vorhersehbarer ist. Weitere Informationen zur Beziehung eines Style-Werts und eines lokalen Eigenschaftswerts finden Sie in der Übersicht über Abhängigkeitseigenschaften.
• Steuerelementautoren schreiben in der Regel ein Steuerelement, das vorlagenfähig ist, aber auch mit einer Standardvorlage enthalten ist. Ihre App kann das Steuerelement verwenden und seine Darstellung ändern, indem eine neue ControlTemplate bereitgestellt wird, die Teil einer in Ressourcen definierten Formatvorlage ist. Diese Formatvorlage wird in der Regel mithilfe des Features für implizite Formatvorlagen angewendet, nicht durch Festlegen Style. Weitere Informationen finden Sie unter Formatieren von Steuerelementen.
• Steuerelementautoren machen auch Eigenschaften verfügbar, die auf Teile eines Steuerelements verweisen, die Formatvorlagen oder Werte aufweisen können, die nur auf diesen Teil angewendet werden, sodass Sie das Steuerelement nicht vollständig neu erstellen müssen. Hier legen Sie eine spezifischere Eigenschaft fest, nicht FrameworkElement.Style.
• Das Modell des visuellen Zustands setzt den Stil des Steuerelements zur Laufzeit häufig als Reaktion auf Änderungen in Zuständen zurück, die sich visuell für die Benutzer manifestieren. Steuerelementvorlagen verfügen z. B. in der Regel über einen "Fokussierten" Zustand, der der Steuerelementdarstellung 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 XAML-Steuerelementvorlagen.

Sie können die Werte einzelner Eigenschaften ändern, die innerhalb einer Formatvorlage festgelegt wurden. Beispielsweise können Sie die Template-Eigenschaft zur Laufzeit festlegen, auch wenn diese Eigenschaft durch eine Formatvorlage festgelegt wurde. Sie können der Sammlung auch Setter in Setters hinzufügen. Sobald diese Formatvorlage jedoch von einem geladenen Objekt verwendet wird, sollte die Formatvorlage als versiegelt betrachtet werden. Sie können diesen Zustand erkennen, indem Sie den Wert von IsSealed für die Style. Eine Formatvorlage wird als verwendet, sobald auf ein geladenes Objekt verwiesen wird, das mit der Objektstruktur einer angezeigten Ui-Seite verbunden ist. A Style und deren Setters Kann auch als versiegelt betrachtet werden, wenn das Objekt, das diese Formatvorlage verwendet, das Loaded-Ereignis auslöst. Wenn Sie versuchen, eine einzelne Eigenschaft einer verwendeten Formatvorlage (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 Format- und Vorlagenanwendung nützlich ist. FrameworkElement definiert den virtuellen Rückruf OnApplyTemplate , der vor dem Laden aufgerufen wird. Von diesem Rückruf 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 aus einer angewendeten Vorlage oder aktiven visuellen Zuständen stammen. Es werden nur Formatvorlagen zurückgegeben, die explizit von der Style Eigenschaft festgelegt wurden. Darüber hinaus gibt sie keine impliziten Formatvorlagen zurück.