Udostępnij za pośrednictwem


FrameworkContentElement.Style Właściwość

Definicja

Pobiera lub ustawia styl do użycia przez ten 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

Zastosowany, nieokreślony styl elementu, jeśli istnieje. W przeciwnym razie wartość null. Wartością domyślną dla konstrukcji FrameworkContentElement domyślnej jest null.

Przykłady

Poniższy przykład ustanawia Resources kolekcję w FlowDocument elemencie głównym, a następnie odwołuje się do niego jako zasób jako określony styl dla elementu 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 przez domyślny styl z motywów lub style zwykle stosowane do obiektów tego typu według zasobów na poziomie strony lub aplikacji (styl niejawny). Ta właściwość nie ustawia ani nie zwraca domyślnych stylów (motywu), ale zwraca niejawny styl lub styl jawny. W przypadku niejawnych lub jawnych stylów nie ma znaczenia, czy styl jest uzyskiwany jako zasób, czy zdefiniowany lokalnie.

Ustawianie stylów ma pewne ograniczenia. Całą właściwość można zresetować Style do nowej Style w dowolnym momencie, co spowoduje wymusi zmiana układu. Jednak po umieszczeniu tego stylu w użyciu przez załadowany element Style należy je uznać za zapieczętowane. Próba wprowadzenia zmiany do dowolnej indywidualnej właściwości stylu w użyciu (na przykład dowolnych elementów w kolekcji ) powoduje zgłoszenie wyjątku Setters. Styl zdefiniowany w adiustacji jest uznawany za używany zaraz po załadowaniu go ze słownika zasobów (dla zasobów) lub strony zawartej w niej jest ładowany (dla stylów wbudowanych).

Style jest właściwością zależności o specjalnym pierwszeństwie. Styl zestawu lokalnego zazwyczaj działa na najwyższym priorytecie w systemie właściwości. Jeśli parametr Style ma wartość null w tym momencie, podczas ładowania systemu właściwości sprawdza, czy są używane niejawne style jako zdefiniowane zasoby, które określają ten typ. Jeśli styl nadal ma wartość null po tym kroku, styl pochodzi ze stylu domyślnego (motywu), ale styl domyślny nie jest zwracany w Style wartości właściwości. Zobacz Pierwszeństwo wartości właściwości zależności.

Użycie atrybutu języka XAML

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

Wartości XAML

resourceExtension
Jeden z następujących elementów: , lub . Zobacz Zasoby XAML.

styleResourceKey
Klucz identyfikujący żądany styl. Klucz odwołuje się do istniejącego zasobu w obiekcie ResourceDictionary.

Uwaga

Składnia elementu właściwości jest technicznie możliwa, ale nie jest zalecana. Zobacz Style i szablony wbudowane. Odwołanie do powiązania przy użyciu szablonuBinding lub Binding jest również możliwe, ale nietypowe.

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

Pole identyfikatora StyleProperty
Właściwości metadanych ustawione na true AffectsMeasure

Dotyczy