Style Style Style Style Class

Tanım

Özellikler, kaynakları ve olay işleyicilerinin bir tür örnekleri arasında paylaşılmasını sağlar.Enables the sharing of properties, resources, and event handlers between instances of a type.

public ref class Style : System::Windows::Threading::DispatcherObject, System::Windows::ISealable, 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.ISealable, System.Windows.Markup.IAddChild, System.Windows.Markup.INameScope, System.Windows.Markup.IQueryAmbient
type Style = class
    inherit DispatcherObject
    interface INameScope
    interface IAddChild
    interface ISealable
    interface IQueryAmbient
Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient, ISealable
Devralma
Öznitelikler
Uygulamalar
System.Windows.ISealableSystem.Windows.ISealableSystem.Windows.ISealableSystem.Windows.ISealable IAddChildIAddChildIAddChildIAddChild INameScopeINameScopeINameScopeINameScope IQueryAmbientIQueryAmbientIQueryAmbientIQueryAmbient

Örnekler

Aşağıdaki örnek etkileyecek bir stil bildirimi gösterir Background özelliği bir Control.The following example shows a style declaration that will affect the Background property of a Control.

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

Yukarıdaki stil uygulamak için aşağıdakileri yapın:To apply the above style, do the following:

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

Kullanarak belirli bir türden tüm öğelerine stil uygulayabilirsiniz TargetType özelliği.You can also apply styles to all elements of a given type by using the TargetType property. Hedef türü stil getirilmesiyle artık ile ayarladığınızdan özelliği tam olarak nitelemek olduğunuz ClassName.PropertyName söz dizimi.Adding the target type to the style means that you no longer have to fully qualify the property you are setting with the ClassName.PropertyName syntax. Aşağıdaki örnek, her uygulanacak bir stil tanımlar TextBlock öğesi.The following example defines a style that will be applied to every TextBlock element.

<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>

Not

Birçok WPFWPF denetimleri, diğer bileşiminden oluşur WPFWPF denetimleri için stil oluşturma bir türdeki tüm denetimlere uygulanır, geniş bir etkiye sahip olabilir.Many WPFWPF controls consist of a combination of other WPFWPF controls, so creating a style that applies to all controls of a type can have broad impact. Örneğin, hedefleyen bir stil oluşturursanız TextBlock denetimlerini bir Canvas, stilini tümüne uygulanır TextBlock tuval denetimlerinde bile TextBlock başka bir denetimde bir parçası olduğu gibi bir ListBox.For instance, if you create a style that targets the TextBlock controls in a Canvas, the style is applied to all TextBlock controls in the canvas, even if the TextBlock is part of another control, such as a ListBox.

Genişletme veya tanımlı bir stil devralma hakkında daha fazla bilgi için bkz: BasedOn sayfası.For information on how to extend or inherit from a defined style, see the BasedOn page.

Açıklamalar

Ayarlayabileceğiniz bir Style türetilen herhangi bir öğedeki FrameworkElement veya FrameworkContentElement.You can set a Style on any element that derives from FrameworkElement or FrameworkContentElement. İçinde bir kaynak olarak bir stil en yaygın olarak bildirilen Resources bölümü.A style is most commonly declared as a resource inside the Resources section. Stilleri kaynaklar olduğundan, bunlar tüm kaynaklarına uygulayan aynı kapsam kurallara uyan bir stil burada da uygulanabilir etkiler bildirmek burada bunu.Because styles are resources, they obey the same scoping rules that apply to all resources, so where you declare a style affects where it can be applied. Örneğin, kök öğe, uygulama tanımının stili bildirirseniz, XAMLXAML dosyası stili, uygulamanızdaki her yerde kullanılabilir.If, for instance, you declare the style in the root element of your application definition XAMLXAML file, the style can be used anywhere in your application. Gezinti uygulaması oluşturuyorsanız ve bir uygulamanın stili bildirmek XAMLXAML yalnızca, Stil dosyaları kullanılabilir XAMLXAML dosya.If you are creating a navigation application and declare the style in one of the application's XAMLXAML files, the style can be used only in that XAMLXAML file. Kapsama kuralları kaynaklar için daha fazla bilgi için bkz: XAML kaynakları.For more information on scoping rules for resources, see XAML Resources.

Stil bildirimi oluşan bir Style içeren bir koleksiyon bir veya daha fazla nesne Setter nesneleri.The style declaration consists of a Style object that contains a collection of one or more Setter objects. Her Setter oluşan bir Property ve Value.Each Setter consists of a Property and a Value. Özellik öğesinin stilini özelliği uygulamak için adıdır.The property is the name of the property of the element the style is to apply to. Bir kaynak olarak stili bildirildikten sonra sonra diğer kaynak gibi başvurulabilir.After the style is declared as a resource, it can then be referenced just like any other resource.

Not

Varsa birden fazla ayarlayıcı aynı ayarlayıcı koleksiyondaki Property özellik değeri, bildirilir ve ayarlayıcının son kullanılır.If there is more than one setter in the setter collection with the same Property property value, the setter that is declared last is used. Benzer şekilde, aynı özellik için bir değer stili ve bir öğeyi doğrudan ayarlarsanız, doğrudan öğede ayarlanan değer öncelik kazanır.Similarly, if you set a value for the same property in a style and on an element directly, the value set on the element directly takes precedence.

Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) Bakım ve sunu ve mantığının ayrımı yanı sıra bir görünüm paylaşımı stil ve şablon oluşturma modeli sağlar.The Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) styling and templating model allows maintenance and sharing of a look as well as the separation of presentation and logic. Stil ve şablon oluşturma modeli özelleştirmenizi sağlayan özellikleri içeren bir paketi içerir, UIUI.The styling and templating model includes a suite of features that enable you to customize your UIUI. Bu paketi özellikleri içeren Style yanı sıra aşağıdaki sınıf:This suite of features includes the Style class as well as the following:

Daha fazla bilgi için stil ve şablon oluşturma.For more information, see Styling and Templating.

Oluşturucular

Style() Style() Style() Style()

Yeni bir örneğini başlatır Style sınıfı.Initializes a new instance of the Style class.

Style(Type) Style(Type) Style(Type) Style(Type)

Yeni bir örneğini başlatır Style belirtilen kullanılacak sınıfı Type.Initializes a new instance of the Style class to use on the specified Type.

Style(Type, Style) Style(Type, Style) Style(Type, Style) Style(Type, Style)

Yeni bir örneğini başlatır Style belirtilen kullanılacak sınıfı Type ve belirtilen temel Style.Initializes a new instance of the Style class to use on the specified Type and based on the specified Style.

Özellikler

BasedOn BasedOn BasedOn BasedOn

Alır veya ayarlar geçerli stili temelidir tanımlanmış bir stil.Gets or sets a defined style that is the basis of the current style.

Dispatcher Dispatcher Dispatcher Dispatcher

Alır Dispatcher bu DispatcherObject ilişkilidir.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed IsSealed

Stil salt okunur ve değiştirilemez olup olmadığını gösteren bir değer alır.Gets a value that indicates whether the style is read-only and cannot be changed.

Resources Resources Resources Resources

Alır veya bu stil kapsamında kullanılabilir kaynakları koleksiyonu ayarlar.Gets or sets the collection of resources that can be used within the scope of this style.

Setters Setters Setters Setters

Bir koleksiyonunu alır Setter ve EventSetter nesneleri.Gets a collection of Setter and EventSetter objects.

TargetType TargetType TargetType TargetType

Alır veya ayarlar için bu stil barındırılmasını türü.Gets or sets the type for which this style is intended.

Triggers Triggers Triggers Triggers

Bir koleksiyonunu alır TriggerBase özellik değerlerini uygulayan nesne belirtilen koşullara bağlı olarak.Gets a collection of TriggerBase objects that apply property values based on specified conditions.

Yöntemler

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Çağıran iş parçacığını erişimi olup olmadığını belirler DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Belirtilen nesnenin geçerli nesneyle eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Bunun için karma kodu döndürür Style.Returns the hash code for this Style.

GetType() GetType() GetType() GetType()

Alır Type geçerli örneği.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Geçerli basit bir kopyasını oluşturur Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object) RegisterName(String, Object)

Yeni bir nesne adı çift içinde geçerli namescope kaydeder.Registers a new name-object pair in the current namescope.

Seal() Seal() Seal() Seal()

Değiştirilemez bu nedenle bu stil ve tüm fabrikaları ve tetikleyiciler kilitler.Locks this style and all factories and triggers so they cannot be changed.

ToString() ToString() ToString() ToString()

Geçerli nesneyi temsil eden bir dize döndürür.Returns a string that represents the current object.

(Inherited from Object)
UnregisterName(String) UnregisterName(String) UnregisterName(String) UnregisterName(String)

Bir ad nesne eşleme namescope kaldırır.Removes a name-object mapping from the namescope.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Çağıran iş parçacığını bu erişimi olduğunu zorlar DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Belirtik Arabirim Kullanımları

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Bir alt nesnesi ekler.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Bir düğüm metin içeriğini nesnesine ekler.Adds the text content of a node to the object.

INameScope.FindName(String) INameScope.FindName(String) INameScope.FindName(String) INameScope.FindName(String)

Belirtilen tanımlayıcı ada sahip bir nesne döndürür.Returns an object that has the provided identifying name.

IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String) IQueryAmbient.IsAmbientPropertyAvailable(String)

Belirtilen bir ortam özelliği geçerli kapsamda kullanılabilir olup olmadığını sorgular.Queries whether a specified ambient property is available in the current scope.

ISealable.CanSeal ISealable.CanSeal ISealable.CanSeal ISealable.CanSeal
ISealable.IsSealed ISealable.IsSealed ISealable.IsSealed ISealable.IsSealed
ISealable.Seal() ISealable.Seal() ISealable.Seal() ISealable.Seal()

Şunlara uygulanır

Ayrıca bkz.