FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style Property

Tanım

Stilini alır veya işlendiğinde bu öğe tarafından kullanılan ayarlar.Gets or sets the style used by this element when it is rendered.

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

Özellik Değeri

Öğesi, varsa uygulanan, varsayılan olmayan stili.The applied, nondefault style for the element, if present. Aksi takdirde, null.Otherwise, null. Varsayılan oluşturulan varsayılan FrameworkElement olduğu null.The default for a default-constructed FrameworkElement is null.

Örnekler

Aşağıdaki örnek, bir kaynak sözlüğünde bir stil tanımlar.The following example defines a style in a resource dictionary.

<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>

Açıklamalar

Denetimler için geçerli stili genellikle bir varsayılan stil denetimi Tema oluşturma tarafından sağlanan veya stilleri o türdeki denetimlere genellikle kaynaklar sayfası veya uygulama düzeyinde (örtük stil) tarafından uygulanan.For controls, the current style is often provided by a default style from control theming, or from styles generally applied to controls of that type by resources at page or application level (an implicit style). Bu özelliği ayarlanmamış veya dönüş varsayılan (tema) stilleri yapar, ancak örtülü bir stil veya öğe üzerinde çalışan bir açık stil döndürmüyor.This property does not set or return default (theme) styles, but it does return either an implicit style or an explicit style that is acting on the element. Stil kaynağı olarak belirtildi ya da yerel olarak tanımlanan örtük veya açık stil söz konusu olduğunda, bu önemli değildir.In the case of implicit or explicit styles, it does not matter whether the style is specified as a resource or defined locally.

Stilleri ayarlama, bazı kısıtlamalar mevcuttur.Setting the styles has some restrictions. Tüm sıfırlayabilirsiniz Style yeni bir özellik Style herhangi bir zamanda, bir düzen yeniden oluşturma zorlayacak.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Ancak, sürede o stilin yüklenen bir öğe tarafından kullanımda yerleştirileceğinden Style düşünülmesi gereken korumalı.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Kullanımdaki stili bireysel herhangi bir özelliği bir değişiklik yapmaya çalışmadan (koleksiyonu içinde herhangi bir şey gibi Setters) bir özel durum oluşturulmasına neden olur.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. Biçimlendirme içinde tanımlanan bir stil (kaynaklar için) bir kaynak sözlüğü'ndan yüklenen ya da sayfanın içinde yer alır (için satır içi stiller) yüklendikten hemen sonra kullanımda olarak kabul edilir.A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Style Özel önceliğe sahip bağımlılık özelliğidir.Style is a dependency property with special precedence. Yerel olarak ayarlanmış style özelliği sistemde genellikle en yüksek öncelik çalışır.The locally set style generally operates at the highest precedence in the property system. Varsa Style bu noktada, özellik sistemi denetler türü belirtin. yerel veya uygulama kaynaklarında örtük stilleri için yükleme sırasında null değil.If the Style is null at this point, during loading the property system checks for implicit styles in local or application resources that specify that type. Stil Bu adımdan sonra hala null sonra acting stili sunu amaçlar için genel varsayılan (tema) stili gelir, ancak varsayılan stili döndürülmez Style özellik değeri.If the style is still null after this step, then the acting style for presentation purposes generally comes from the default (theme) style, but the default style is not returned in the Style property value. Bkz: bağımlılık özelliği değer önceliği veya stil ve şablon oluşturma.See Dependency Property Value Precedence or Styling and Templating.

XAML Öznitelik KullanımıXAML Attribute Usage

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

XAML Özellik Öğesi KullanımıXAML Property Element Usage

XAML DeğerleriXAML Values

resourceExtensionresourceExtension
Aşağıdakilerden biri:, veya.One of the following: , or . Bkz: XAML kaynakları.See XAML Resources.

styleResourceKeystyleResourceKey
İstenen stili tanımlayan anahtar.The key that identifies the style being requested. Var olan bir kaynak anahtarı başvuran bir ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Not

Özellik öğesi sözdizimine teknik olarak mümkün, ancak çoğu stili senaryosu için önerilmez.Property element syntax is technically possible, but not recommended for most style scenarios. Bkz: satır içi stilleri ve şablonları.See Inline Styles and Templates. Bağlama kullanarak başvuru veya Binding de mümkün ama seyrek olduğundan.A binding reference using or Binding is also possible, but uncommon.

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanIdentifier field StyleProperty
Meta veri özelliklerini ayarlamak trueMetadata properties set to true AffectsMeasure

Şunlara uygulanır