FrameworkElement.Style Property

Ruft einen Instanz-Style ab oder legt eine solchen fest, der während des Rendering und im Layout für dieses Objekt angewendet wird.

Syntax


public Style Style { get; set; }


<frameworkElement Style="{StaticResource styleResourceKey}"/>

XAML Values

styleResourceKey

Der Schlüssel, der den angeforderten Stil identifiziert. Der Schlüssel verweist auf ein ResourceDictionary in eine vorhandene Ressource.

Hinweis  Das Definieren eines Inlinestils mit XAML-Syntax für Eigenschaftenelemente ist theoretisch möglich, wird jedoch zum Festlegen von FrameworkElement nicht empfohlen.Style Der Grund ist, dass jede Eigenschaft, die mit einer einmaligen Inlineformatvorlage festgelegt wird, auch durch das direkte Festlegen der Eigenschaft als XAML-Attribut (oder Eigenschaftselement) bestimmt werden kann. Das Definieren eines Stils für einmalige Verwendung zum Festlegen der gleichen Eigenschaft, gilt im Allgemeinen als schlechter Markupstil und kann zu einem verwirrenden Laufzeitverhalten beim Festlegen von Eigenschaften führen.

Eigenschaftswert

Typ: Style

Der angewendete Stil für das Objekt, sofern vorhanden, andernfalls null. Der Standardwert für ein mit den Standardwerten konstruiertes FrameworkElement ist null.

Hinweise

Das direkte Festlegen der Style-Eigenschaft ist nicht das übliche Verfahren zum Formatieren der Darstellung eines Benutzeroberflächenelements. Stattdessen beeinflussen Sie die Darstellung eines Benutzeroberflächenelements mit einem der folgenden Verfahren:

  • Es werden häufig einzelne Benutzeroberflächen-Eigenschaften eines Benutzeroberflächenelements als Attribute in XAML festgelegt. FrameworkElement.Style gilt nur für das aktuelle Element, und jeder Wert von StyleFrameworkElement.Style wird von einem lokalen Eigenschaftswert überschrieben, sodass das Festlegen des lokalen Werts direkter und genauer vorhersagbar ist. Weitere Informationen zur Beziehung eines Style-Werts und eines lokalen Eigenschaftswerts finden Sie in der Übersicht über Abhängigkeitseigenschaften.
  • Steuerelementautoren schreiben in der Regel ein Steuerelement, für das eine Vorlage erstellt werden kann, das jedoch auch eine Standardvorlage hat. Die App kann das Steuerelement verwenden und seine Darstellung ändern, indem sie eine neue ControlTemplate-Klasse bereitstellt, die Teil einer in Ressourcen definierten Style-Klasse ist. Dieses Format wird in der Regel mithilfe der impliziten Formatfunktion angewendet, und nicht durch Festlegen von Style. Weitere Informationen finden Sie unter Schnellstart: Formatieren von Steuerelementen.
  • Steuerelemententwickler können auch Eigenschaften verfügbar machen, die auf Teile eines Steuerelements verweisen, die Formate oder Werte haben können, die genau auf diesen Teil angewendet werden. Auf diese Weise müssen Sie keine völlig neue Vorlage für das Steuerelement erstellen. Hier legen Sie eine spezifischere Eigenschaft, nicht FrameworkElement.Style, fest.
  • Das Modell des visuellen Zustands setzt häufig zur Laufzeit das Format des Steuerelements als Reaktion auf Änderungen in den Zuständen zurück, die sich den Benutzern in visueller Form zeigen. Beispielsweise verfügen Steuerelementvorlagen in der Regel über einen "Focused"-Zustand, bei dem ein visueller Fokusindikator zur Darstellung der Steuerelemente hinzugefügt wird, damit ein Benutzer, der eine Tastatur verwendet, sehen kann, welches Element auf der Benutzeroberfläche den aktuellen Tastaturfokus hat. Weitere Informationen zum Konzept des visuellen Zustands finden Sie unter Schnellstart: Steuerelementvorlagen.

Sie können die Werte einzelner Eigenschaften ändern, die innerhalb eines Stils festgelegt wurden. Beispielsweise können Sie die Template-Eigenschaft zur Laufzeit festlegen, auch wenn diese von einem Stil definiert wurde. Oder Sie können der Auflistung in Setters Setter hinzufügen. Sobald jedoch ein Stil von einem geladenen Objekt verwendet wird, sollte der Style als versiegelt angesehen werden. Sie können diesen Zustand erkennen, indem Sie den Wert von IsSealed auf den Style überprüfen. Ein Stil gilt dann als in Verwendung, wenn ein geladenes Objekt, das mit der Objektstruktur einer angezeigten Seite der Benutzeroberfläche verknüpft ist, darauf verweist. Style und die zugehörigen Setters werden als versiegelt angesehen, wenn das Objekt, das diesen Stil verwendet, sein Loaded-Ereignis auslöst. Wenn Sie versuchen, eine einzelne Eigenschaft eines verwendeten Stils zu ändern (beispielsweise als eine Eigenschaft in der Setters-Auflistung), wird eine Ausnahme ausgelöst.

Die Klassen, die von Control abgeleitet werden, haben einen zusätzlichen Einstiegspunkt, der Autoren hinsichtlich der Format- und Vorlagen-Anwendung nützlich ist. FrameworkElement definiert den virtuellen Rückruf OnApplyTemplate, der vor Loaded aufgerufen wird. Die Klassen, die von Control abgeleitet werden, können diesen Rückruf überschreiben, sodass die Eigenschaftswerte, die vor der Verwendung des Formats durch Vorlagen festgelegt wurden, angepasst werden.

Bei einer Abfrage zur Laufzeit gibt die Style-Eigenschaft keine Formate aus einer angewendeten Vorlage und keine aktiven, visuellen Zustände zurück. Zurückgegeben werden nur Stile, die explizit durch die Eigenschaft Style festgelegt worden sind. Außerdem gibt sie keine impliziten Stile zurück.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadaten

Windows.winmd

Siehe auch

FrameworkElement
Schnellstart: Steuerelemente für die Formatierung
Style
Control

 

 

Anzeigen:
© 2015 Microsoft