FrameworkContentElement.Style Eigenschaft

Definition

Ruft den Stil ab, der von diesem Element verwendet werden soll, oder legt ihn fest.Gets or sets the style to be used by this element.

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 FrameworkContentElement ist null.The default for a default-constructed FrameworkContentElement is null.

Beispiele

Im folgenden Beispiel wird eine Resources-Auflistung für ein FlowDocument root-Element erstellt und dann als eine Ressource als eine bestimmte Formatvorlage für einen Paragraphdarauf verwiesen.The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a Paragraph.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

Hinweise

Der aktuelle Stil wird häufig von einem Standardstil aus Design oder von Stilen bereitgestellt, die in der Regel durch Ressourcen auf der Seiten-oder Anwendungsebene (ein implizites Format) auf Objekte dieses Typs angewendet werden.The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Diese Eigenschaft legt Standard Stile (Theme) nicht fest oder gibt Sie zurück, aber Sie gibt den impliziten Stil oder einen expliziten Stil zurück.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. Im Fall impliziter oder expliziter Stile spielt es keine Rolle, ob auf den Stil als Ressource zugegriffen oder lokal definiert ist.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

Das Festlegen der Stile hat einige Einschränkungen.Setting the styles has some restrictions. Sie können die gesamte Style-Eigenschaft zu einem beliebigen Zeitpunkt auf eine neue Style zurücksetzen, wodurch eine Neukomposition des Layouts erzwungen wird.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Sobald dieser Stil jedoch von einem geladenen Element verwendet wird, sollte die Style als versiegelt angesehen werden.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Der Versuch, eine Änderung an einer einzelnen Eigenschaft eines in Gebrauch verwendeten Stils vorzunehmen (z. b. in der Auflistung von Setters), bewirkt, dass 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 Stil, der im Markup definiert ist, wird als in Gebrauch betrachtet, sobald er aus einem Ressourcen Wörterbuch (für Ressourcen) geladen wird, oder wenn die in enthaltene Seite geladen wird (für Inline Stile).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ängigkeits Eigenschaft mit spezieller Rangfolge.Style is a dependency property with special precedence. Der lokal festgelegte Stil arbeitet im Allgemeinen mit der höchsten Rangfolge im Eigenschaften System.The locally set style generally operates at the highest precedence in the property system. Wenn die Style zu diesem Zeitpunkt NULL ist, prüft beim Laden des Eigenschaften Systems beim Laden auf implizite Stile als definierte Ressourcen, die diesen Typ angeben.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Wenn der Stil nach diesem Schritt immer noch NULL ist, wird der Stil aus dem Standardformat (Design) abgeleitet, aber der Standardstil wird nicht im Style-Eigenschafts Wert zurückgegeben.If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. Siehe Wert Rangfolge der Abhängigkeits Eigenschaft.See Dependency Property Value Precedence.

Verwendung von XAML-AttributenXAML Attribute Usage

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

XAML-WerteXAML Values

resourceextensionresourceExtension
Eines der folgenden:, oder.One of the following: , or . Siehe XAML-Ressourcen.See XAML Resources.

styleresourcekeystyleResourceKey
Der Schlüssel, der den angeforderten Stil bezeichnet.The key that identifies the style being requested. Der Schlüssel verweist auf eine vorhandene Ressource in einer ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Hinweis

Die Syntax von Eigenschafts Elementen ist technisch möglich, wird jedoch nicht empfohlen.Property element syntax is technically possible, but not recommended. Weitere Informationen finden Sie unter Inline Stile und Vorlagen.See Inline Styles and Templates. Ein Bindungs Verweis mit TemplateBinding oder Binding ist ebenfalls möglich, aber nicht üblich.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field StyleProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true AffectsMeasure

Gilt für: