FrameworkContentElement.Style Eigenschaft

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

Die angewendete, nicht standardmäßige Formatvorlage für das Element, falls vorhanden. Andernfalls, null. Die Standardeinstellung für ein standardmäßig konstruiertes FrameworkContentElement Format 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 einem Standarddesign oder von Formatvorlagen bereitgestellt, die in der Regel auf Objekte dieses Typs von Ressourcen auf Seiten- oder Anwendungsebene (eine implizite Formatvorlage) angewendet werden. Diese Eigenschaft legt keine Standardformatvorlagen (Designformatvorlagen) fest oder gibt sie 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 zugegriffen 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, sucht das Eigenschaftensystem beim Laden 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 (Designformatvorlage), die Standardformatvorlage wird jedoch nicht im Style Eigenschaftswert zurückgegeben. Siehe Dependency Property Value Precedence.

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.

Informationen zur Abhängigkeitseigenschaft