FrameworkElement.Style Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft den von diesem Element beim Rendern verwendeten Stil ab oder legt ihn fest.

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

public System.Windows.Style Style { get; set; }

member this.Style : System.Windows.Style with get, set

Public Property Style As Style

Eigenschaftswert

Style

Der übernommene und nicht dem Standardstil entsprechende Stil für das Element, wenn ein Stil vorhanden ist. Andernfalls null. Der Standardwert für ein mit den Standardwerten konstruiertes FrameworkElement ist null.

Beispiele

Im folgenden Beispiel wird eine Formatvorlage in einem Ressourcenwörterbuch definiert.

<Page.Resources>

<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>

<Border Style="{StaticResource PageBackground}">

</Border>

Hinweise

Bei Steuerelementen wird die aktuelle Formatvorlage häufig von einem Standardformat aus der Steuerelementgestaltung oder von Formatvorlagen bereitgestellt, die in der Regel auf Steuerelemente dieses Typs auf Seite- oder Anwendungsebene (implizite Formatvorlage) angewendet werden. Diese Eigenschaft legt keine Standardformatvorlagen (Designformatvorlagen) fest, gibt jedoch entweder eine implizite Formatvorlage oder eine explizite Formatvorlage zurück, die auf das Element wirkt. Bei impliziten oder expliziten Formatvorlagen ist es nicht wichtig, ob die Formatvorlage als Ressource oder lokal definiert ist.

Das Festlegen der Formatvorlagen weist einige Einschränkungen auf. Sie können die gesamte Eigenschaft jederzeit auf eine neue Style Zurücksetzung zurücksetzen, die eine Layoutrecomposition erzwingtStyle. Sobald diese Formatvorlage jedoch von einem geladenen Element verwendet wird, sollte dies Style als versiegelt betrachtet werden. Wenn Sie versuchen, eine Änderung an einer einzelnen Eigenschaft eines in-use-Stils vorzunehmen (z. B. alles innerhalb der Auflistung von Setters), wird eine Ausnahme ausgelöst. Eine Formatvorlage, die im Markup definiert ist, wird als verwendet, sobald sie aus einem Ressourcenwörterbuch (für Ressourcen) geladen wird, oder die Seite, in der sie enthalten ist, wird geladen (für Inlineformatvorlagen).

Style ist eine Abhängigkeitseigenschaft mit besonderer Priorität. Die lokal festgelegte Formatvorlage funktioniert im Allgemeinen am höchsten Rang im Eigenschaftssystem. Wenn dies null ist, überprüft das Style Eigenschaftssystem während des Ladens impliziter Formatvorlagen in lokalen oder Anwendungsressourcen, die diesen Typ angeben. Wenn die Formatvorlage nach diesem Schritt immer noch NULL ist, stammt im Allgemeinen der Formatvorlage für Präsentationszwecke der Standardformatvorlage (Design), aber der Standardformat wird nicht im Style Eigenschaftswert zurückgegeben. Siehe Dependency-Eigenschaftswertfolge oder Formatieren und Templating.

Verwendung von XAML-Attributen

<object Style="{resourceExtension styleResourceKey}"/>  

Verwendung von XAML-Eigenschaftenelementen

XAML-Werte

resourceExtension
Eine der folgenden: oder . Weitere Informationen finden Sie unter XAML-Ressourcen.

styleResourceKey
Der Schlüssel, der die angeforderte Formatvorlage identifiziert. Der Schlüssel verweist auf eine vorhandene Ressource in einer ResourceDictionary.

Hinweis

Die Eigenschaftselementsyntax ist technisch möglich, wird jedoch für die meisten Formatszenarien nicht empfohlen. Siehe Inlineformatvorlagen und Vorlagen. Ein Bindungsverweis mithilfe von TemplateBinding oder Binding ist auch möglich, aber ungewöhnlich.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	StyleProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure