FrameworkElement.Style Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft die Formatvorlage ab, die von diesem Element beim Rendern verwendet wird, oder legt diese 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

Die angewendete, nicht standardmäßige Formatvorlage für das Element, falls vorhanden. Andernfalls, null. Die Standardeinstellung für ein standardmäßig konstruiertes FrameworkElement Format 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 Standardstil aus Steuerelementdesign oder von Formatvorlagen bereitgestellt, die in der Regel auf Steuerelemente dieses Typs nach Ressourcen auf Seiten- oder Anwendungsebene (implizite Formatvorlage) angewendet werden. Diese Eigenschaft legt keine Standardformatvorlagen (Designformatvorlagen) fest oder gibt sie zurück, gibt jedoch entweder eine implizite Oder eine explizite Formatvorlage zurück, die für das Element fungiert. Bei impliziten oder expliziten Formatvorlagen spielt es keine Rolle, ob die Formatvorlage als Ressource angegeben oder lokal definiert wird.

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

Style ist eine Abhängigkeitseigenschaft mit besonderer Rangfolge. Die lokal festgelegte Formatvorlage wird in der Regel mit der höchsten Rangfolge im Eigenschaftensystem ausgeführt. Wenn der Style Wert an diesem Punkt null ist, überprüft das Eigenschaftensystem beim Laden auf implizite Stile in lokalen oder Anwendungsressourcen, die diesen Typ angeben. Wenn die Formatvorlage nach diesem Schritt noch NULL ist, stammt die schauspielende Formatvorlage für Präsentationszwecke im Allgemeinen aus dem Standardstil (Designformatvorlage), die Standardformatvorlage wird jedoch nicht im Style Eigenschaftswert zurückgegeben. Siehe Dependency Property Value Precedence or Styling and Templating.

Verwendung von XAML-Attributen

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

XAML-Eigenschaftselementverwendung

XAML-Werte

resourceExtension Eine der folgenden: , oder . Siehe XAML-Ressourcen.

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

Hinweis

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

Informationen zur Abhängigkeitseigenschaft

Element	Wert
Bezeichnerfeld	StyleProperty
Auf Metadateneigenschaften festgelegt true	AffectsMeasure