FrameworkContentElement.Style Eigenschaft

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Stil ab, der von diesem Element verwendet werden soll, 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 FrameworkContentElement ist null.

Beispiele

Im folgenden Beispiel wird eine Resources Auflistung für ein FlowDocument Stammelement eingerichtet und dann als Ressource als bestimmte Formatvorlage für ein 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

Die aktuelle Formatvorlage wird häufig von einer Standardformatvorlage aus dem Design oder von Formatvorlagen bereitgestellt, die in der Regel auf Objekte dieses Typs von Ressourcen auf Seite- oder Anwendungsebene (implizite Formatvorlage) angewendet werden. Diese Eigenschaft legt keine Standardformatvorlagen (Designformatvorlagen) fest oder gibt diese zurück, gibt jedoch die implizite Formatvorlage oder eine explizite Formatvorlage zurück. Bei impliziten oder expliziten Formatvorlagen spielt es keine Rolle, ob auf die Formatvorlage als Ressource 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ücksetzen, wodurch eine Neukomposition des Layouts erzwungen wird. 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 einer in-use-Formatvorlage vorzunehmen (z. B. alles innerhalb der Sammlung von Setters), wird eine Ausnahme ausgelöst. Eine formatierte 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 Rangfolge. Die lokal festgelegte Formatvorlage funktioniert in der Regel am höchsten Rang im Eigenschaftensystem. Wenn die Style Null an diesem Punkt ist, überprüft das Eigenschaftensystem nach impliziten Formatvorlagen als definierte Ressourcen, die diesen Typ angeben. Wenn die Formatvorlage nach diesem Schritt noch null ist, stammt die Formatvorlage aus der Standardformatvorlage (Design), aber die Standardformatvorlage wird nicht im Style Eigenschaftswert zurückgegeben. Siehe Rangfolge der Abhängigkeitseigenschaft.

Verwendung von XAML-Attributen

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

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

Eigenschaftenelementsyntax ist technisch möglich, aber 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

Gilt für