FrameworkContentElement.Style Właściwość

Definicja

Pobiera lub ustawia styl, który będzie używany przez ten element.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

Wartość właściwości

Stosowany, niedomyślny styl elementu, jeśli jest obecny.The applied, nondefault style for the element, if present. W przeciwnym razie wartość null.Otherwise, null. Domyślna FrameworkContentElement skonstruowana domyślnie jest null.The default for a default-constructed FrameworkContentElement is null.

Przykłady

Poniższy przykład ustanawia Resources kolekcję na FlowDocument elemencie głównym, a następnie odwołuje się do niego jako zasób jako określony styl dla 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>

Uwagi

Bieżący styl jest często dostarczany przy użyciu stylu domyślnego z motywów lub stylów zwykle stosowanych do obiektów tego typu według zasobów na poziomie strony lub aplikacji (styl niejawny).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). Ta właściwość nie ustawia ani nie zwraca domyślnych stylów (motywu), ale zwraca styl niejawny lub jawny styl.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. W przypadku niejawnych lub jawnych stylów nie ma znaczenia, czy styl jest dostępny jako zasób lub zdefiniowany lokalnie.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

Ustawienie stylów ma pewne ograniczenia.Setting the styles has some restrictions. W dowolnym momencie możesz zresetować całą Właściwość Style do nowej Style, co spowoduje wymuszenie odtworzenia układu.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Jednakże, gdy tylko ten styl jest używany przez załadowany element, Style powinien być uważany za zapieczętowany.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Podjęto próbę dokonania zmiany we właściwościach w stylu w użyciu (takich jak wszystkie elementy w kolekcji Setters) powoduje zgłoszenie wyjątku.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. Styl zdefiniowany w znacznikach jest traktowany jako używany zaraz po załadowaniu go ze słownika zasobów (dla zasobów) lub strony, w której jest zawarty w programie, jest ładowany (dla stylów wbudowanych).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 jest właściwością zależności z specjalnym pierwszeństwem.Style is a dependency property with special precedence. Lokalnie ustawiony styl zazwyczaj działa przy najwyższym priorytecie w systemie właściwości.The locally set style generally operates at the highest precedence in the property system. Jeśli w tym momencie Style ma wartość null, podczas ładowania systemu właściwości sprawdza niejawne style jako zdefiniowane zasoby, które określają ten typ.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Jeśli styl nadal ma wartość null po wykonaniu tego kroku, styl pochodzi z domyślnego stylu (motywu), ale styl domyślny nie jest zwracany w wartości właściwości Style.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. Zobacz pierwszeństwo wartości właściwości zależności.See Dependency Property Value Precedence.

Użycie atrybutu języka XAMLXAML Attribute Usage

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

Wartości XAMLXAML Values

resourceExtensionresourceExtension
Jeden z następujących elementów:, lub.One of the following: , or . Zobacz zasoby XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Klucz, który identyfikuje żądany styl.The key that identifies the style being requested. Klucz odnosi się do istniejącego zasobu w ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Uwaga

Składnia elementu właściwości jest technicznie możliwa, ale nie jest zalecana.Property element syntax is technically possible, but not recommended. Zobacz wbudowane style i szablony.See Inline Styles and Templates. Odwołanie do powiązania przy użyciu szablonu TemplateBinding lub Binding jest również możliwe, ale nietypowe.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field StyleProperty
Właściwości metadanych ustawione na trueMetadata properties set to true AffectsMeasure

Dotyczy