FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style Property

Definition

Ruft den von diesem Element beim Rendern verwendeten Stil ab oder legt ihn fest.Gets or sets the style used by this element when it is rendered.

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

Der übernommene und nicht dem Standardstil entsprechende Stil für das Element, wenn ein Stil vorhanden ist.The applied, nondefault style for the element, if present. Andernfalls null.Otherwise, null. Der Standardwert für ein mit den Standardwerten konstruiertes FrameworkElement ist null.The default for a default-constructed FrameworkElement is null.

Beispiele

Im folgende Beispiel wird ein Stil in einem Ressourcenverzeichnis definiert.The following example defines a style in a resource dictionary.

<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>

Hinweise

Für Steuerelemente ist der aktuelle Stil häufig von einer Standardformatvorlage aus den Steuerelementdesigns bereitgestellt oder von Stilen in der Regel auf Steuerelemente angewendet werden von diesem Typ von Ressourcen auf Seiten- oder Anwendungsebene (ein impliziter Stil).For controls, the current style is often provided by a default style from control theming, or from styles generally applied to controls of that type by resources at page or application level (an implicit style). Diese Eigenschaft ist nicht festgelegt oder return-Standard Designstile, aber es gibt entweder eine implizite oder explizite Stil, der für das Element fungiert zurück.This property does not set or return default (theme) styles, but it does return either an implicit style or an explicit style that is acting on the element. Im Fall von impliziten oder expliziten Stilen spielt es keine Rolle, ob der Stil als eine Ressource angegeben oder lokal definiert ist.In the case of implicit or explicit styles, it does not matter whether the style is specified as a resource or defined locally.

Festlegen der Stile weist einige Einschränkungen.Setting the styles has some restrictions. Sie können die gesamte zurücksetzen Style Eigenschaft, um ein neues Style erzwingt die zu jedem Zeitpunkt eine Neuerstellung Layout.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Allerdings so schnell wie Stil verwendet verwendet wird, von einem geladenen Element, das Style angesehen werden versiegelt.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Eine einzelne Eigenschaft eines Stils verwendet eine Änderung vornehmen möchten (z. B. ein Element innerhalb der Auflistung von Setters) löst eine Ausnahme ausgelöst wird.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. Ein Format, das im Markup definierte gilt, sobald es, aus einem Ressourcenverzeichnis (für Ressourcen geladen wird), oder der Seite, die, der es enthalten ist (für Inlineformatvorlagen laden) verwendet werden.A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Style ist eine Abhängigkeitseigenschaft mit besonderer Rangfolge.Style is a dependency property with special precedence. Die lokal festgelegte Format, die in der Regel mit der höchsten Priorität im Eigenschaftensystem verarbeitet werden.The locally set style generally operates at the highest precedence in the property system. Wenn die Style null ist an diesem Punkt während des Ladens, die Eigenschaft wird überprüft, ob implizite Stile in die lokale oder eine Anwendung Ressourcen, die diesen Typ angeben.If the Style is null at this point, during loading the property system checks for implicit styles in local or application resources that specify that type. Wenn nach diesem Schritt das Format noch null ist wird der verwendete Stil für die Darstellung in der Regel aus den Standardstil (Design), aber das Standardformat nicht, in zurückgegeben wird der Style -Eigenschaftswert.If the style is still null after this step, then the acting style for presentation purposes generally comes from the default (theme) style, but the default style is not returned in the Style property value. Finden Sie unter Abhängigkeitseigenschaftswerten oder Stile und Vorlagen.See Dependency Property Value Precedence or Styling and Templating.

Verwendung von XAML-AttributenXAML Attribute Usage

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

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

XAML-WerteXAML Values

resourceExtensionresourceExtension
Eine der folgenden:, oder.One of the following: , or . Finden Sie unter XAML-Ressourcen.See XAML Resources.

styleResourceKeystyleResourceKey
Der Schlüssel, der das angeforderte Format identifiziert.The key that identifies the style being requested. Der Schlüssel verweist auf eine vorhandene Ressource in einem ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Hinweis

Eigenschaftenelement-Syntax ist technisch möglich, aber nicht empfohlen, für die meisten Style-Szenarien.Property element syntax is technically possible, but not recommended for most style scenarios. Finden Sie unter Inlinestile und-Vorlagen.See Inline Styles and Templates. Ein Bindung mit oder Binding ist auch möglich, jedoch nicht empfohlen.A binding reference using or Binding is also possible, but uncommon.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field StyleProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true AffectsMeasure

Gilt für: