FrameworkContentElement.Style Özellik

Tanım

Bu öğe tarafından kullanılacak stili alır veya ayarlar.Gets or sets the style to be used by this element.

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

Style

Varsa, öğe için uygulanmış, varsayılan olmayan stil.The applied, nondefault style for the element, if present. Tersi durumda null.Otherwise, null. Varsayılan olarak oluşturulan varsayılan değer FrameworkContentElement null .The default for a default-constructed FrameworkContentElement is null.

Örnekler

Aşağıdaki örnek, bir Resources kök öğe üzerinde bir koleksiyon oluşturur FlowDocument ve ardından buna özel bir stil olarak kaynak olarak başvurur Paragraph .The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a 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>

Açıklamalar

Geçerli stil, genellikle Tema 'dan varsayılan bir stil veya sayfa ya da uygulama düzeyinde (örtülü bir stil) bu tür nesnelere uygulanan stillerden oluşur.The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Bu özellik varsayılan (Tema) stilleri ayarlayıp döndürmez, ancak örtülü stili veya açık stili döndürür.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. Örtük veya açık stiller söz konusu olduğunda, stile kaynak olarak erişilip erişilmediğini veya yerel olarak tanımlanıp tanımlanmadığına bakılmaksızın.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

Stillerin ayarlanması bazı kısıtlamalar içerir.Setting the styles has some restrictions. Tüm Style özelliği dilediğiniz zaman yeni bir şekilde sıfırlayabilirsiniz Style , bu da Düzen yeniden oluşturmaya zorlanır.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Ancak, bu stil yüklenmiş bir öğe tarafından kullanımda yerleştirildiğinde, Style korumalı olarak kabul edilmelidir.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Kullanımda olan bir stilin herhangi bir özelliğinde (örneğin, koleksiyonu içindeki herhangi bir şey) değişiklik yapmaya çalışılması bir Setters özel durumun 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 bölümünde tanımlanan bir stil, bir kaynak sözlüğünden (kaynaklar için) yüklendiği anda kullanımda olarak değerlendirilir veya içinde bulunduğu sayfa yüklenir (satır içi stiller için).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 bir bağımlılık özelliğidir.Style is a dependency property with special precedence. Yerel olarak ayarlanan stil, genellikle özellik sisteminin en yüksek önceliğinde çalışır.The locally set style generally operates at the highest precedence in the property system. StyleBu noktada null ise, özellik sistemi yükleme sırasında, bu türü belirten tanımlanmış kaynaklar olarak örtük stilleri denetler.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Bu adımdan sonra stil hala null ise, stil varsayılan (Tema) stilinden gelir, ancak varsayılan stil, Style Özellik değerinde döndürülmez.If the style is still null after this step, then the style 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.See Dependency Property Value Precedence.

XAML Öznitelik KullanımıXAML Attribute Usage

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

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. Anahtar, içindeki var olan bir kaynağı ifade eder ResourceDictionary .The key refers to an existing resource in a ResourceDictionary.

Not

Özellik öğesi sözdizimi teknik açıdan olasıdır, ancak önerilmez.Property element syntax is technically possible, but not recommended. Bkz. satır Içi stiller ve şablonlar.See Inline Styles and Templates. TemplateBinding veya Binding , yaygın olarak kullanılan bir bağlama başvurusu.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

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

Tanımlayıcı alanıIdentifier field StyleProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true AffectsMeasure

Şunlara uygulanır