Style Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Umożliwia udostępnianie właściwości, zasobów i procedur obsługi zdarzeń między wystąpieniami typu.

public ref class Style : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IAddChild, System::Windows::Markup::INameScope, System::Windows::Markup::IQueryAmbient

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.DictionaryKeyProperty("TargetType")]
public class Style : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IAddChild, System.Windows.Markup.INameScope, System.Windows.Markup.IQueryAmbient

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type Style = class
    inherit DispatcherObject
    interface IAddChild
    interface INameScope
    interface IQueryAmbient

Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient

Dziedziczenie

Object

DispatcherObject

Style

Atrybuty

LocalizabilityAttribute ContentPropertyAttribute DictionaryKeyPropertyAttribute

Implementuje

IAddChild INameScope IQueryAmbient

Przykłady

W poniższym przykładzie pokazano deklarację stylu, która będzie mieć wpływ na Background właściwość Controlobiektu .

<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>

Aby zastosować powyższy styl, wykonaj następujące czynności:

<Label Content="Yellow Background" Style="{StaticResource Style1}" />

Style można również stosować do wszystkich elementów danego typu przy użyciu TargetType właściwości . Dodanie typu docelowego do stylu oznacza, że nie trzeba już w pełni kwalifikować właściwości, która jest ustawiana przy użyciu ClassName.PropertyName składni. W poniższym przykładzie zdefiniowano styl, który zostanie zastosowany do każdego TextBlock elementu.

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

Uwaga

Wiele kontrolek WPF składa się z kombinacji innych kontrolek WPF, więc utworzenie stylu, który ma zastosowanie do wszystkich kontrolek typu, może mieć szeroki wpływ. Jeśli na przykład utworzysz styl przeznaczony TextBlock dla kontrolek w Canvasobiekcie , styl zostanie zastosowany do wszystkich TextBlock kontrolek na kanwie, nawet jeśli TextBlock element jest częścią innej kontrolki, takiej jak ListBox.

Aby uzyskać informacje na temat rozszerzania lub dziedziczenia ze zdefiniowanego stylu, zobacz BasedOn stronę.

Uwagi

Można ustawić Style dla dowolnego elementu, który pochodzi od FrameworkElement lub FrameworkContentElement. Styl jest najczęściej deklarowany jako zasób w Resources sekcji . Ponieważ style są zasobami, przestrzegają tych samych reguł określania zakresu, które mają zastosowanie do wszystkich zasobów, więc deklarowanie stylu wpływa na to, gdzie można je zastosować. Jeśli na przykład zadeklarujesz styl w elemecie głównym pliku XAML definicji aplikacji, styl może być używany w dowolnym miejscu w aplikacji. Jeśli tworzysz aplikację nawigacji i deklarujesz styl w jednym z plików XAML aplikacji, styl może być używany tylko w tym pliku XAML. Aby uzyskać więcej informacji na temat reguł określania zakresu dla zasobów, zobacz Zasoby XAML.

Deklaracja stylu składa się z Style obiektu zawierającego kolekcję co najmniej jednego Setter obiektu. Każda Setter z nich składa się z elementów i PropertyValue. Właściwość jest nazwą właściwości elementu, do których ma być stosowany styl. Po zadeklarowaniu stylu jako zasobu można go odwołać tak samo jak każdy inny zasób.

Uwaga

Jeśli w kolekcji setter istnieje więcej niż jeden zestaw o tej samej Property wartości właściwości, używany jest ustawiający zadeklarowany ostatnio. Podobnie, jeśli ustawisz wartość dla tej samej właściwości w stylu i bezpośrednio w elemencie, wartość ustawiona na elemencie bezpośrednio ma pierwszeństwo.

Model stylów Windows Presentation Foundation (WPF) i tworzenia szablonów umożliwia konserwację i udostępnianie wyglądu, a także rozdzielenie prezentacji i logiki. Model stylów i tworzenia szablonów zawiera zestaw funkcji, które umożliwiają dostosowanie interfejsu użytkownika. Ten zestaw funkcji obejmuje klasę Style , a także następujące elementy:

• Trigger

• EventTrigger i Storyboard

• ControlTemplate

• DataTemplate

Aby uzyskać więcej informacji, zobacz Styling and Templating (Tworzenie stylów i tworzenie szablonów).

Konstruktory

Style()	Inicjuje nowe wystąpienie klasy Style.
Style(Type)	Inicjuje Style nowe wystąpienie klasy do użycia w określonym Typeobiekcie .
Style(Type, Style)	Inicjuje Style nowe wystąpienie klasy do użycia w określonym Type i na podstawie określonego Styleelementu .

Właściwości

BasedOn	Pobiera lub ustawia zdefiniowany styl, który jest podstawą bieżącego stylu.
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy styl jest tylko do odczytu i nie można go zmienić.
Resources	Pobiera lub ustawia kolekcję zasobów, które mogą być używane w zakresie tego stylu.
Setters	Pobiera kolekcję Setter obiektów i EventSetter .
TargetType	Pobiera lub ustawia typ, dla którego ten styl jest przeznaczony.
Triggers	Pobiera kolekcję TriggerBase obiektów, które stosują wartości właściwości na podstawie określonych warunków.

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Zwraca kod skrótu dla tego Style.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RegisterName(String, Object)	Rejestruje nową parę name-object w bieżącym horyzakresie nazw.
Seal()	Blokuje ten styl i wszystkie fabryki i wyzwalacze, aby nie można było ich zmienić.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
UnregisterName(String)	Usuwa mapowanie obiektów nazw z zakresu nazw.
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)	Dodaje obiekt podrzędny.
IAddChild.AddText(String)	Dodaje do obiektu zawartość tekstową węzła.
INameScope.FindName(String)	Zwraca obiekt, który ma podaną nazwę identyfikującą.
IQueryAmbient.IsAmbientPropertyAvailable(String)	Kwerenda, czy określona właściwość otoczenia jest dostępna w bieżącym zakresie.

Zobacz też

• x:Key, atrybut
• x:Type — Rozszerzenie znaczników
• Wprowadzenie do przykładu stylów i tworzenia szablonów