FrameworkElement.Style Właściwość

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 null. Wartość domyślna dla konstrukcji FrameworkElement domyślnej to null.

Przykłady

Poniższy przykład definiuje styl w słowniku zasobów.

<Page.Resources>

<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>

<Border Style="{StaticResource PageBackground}">

</Border>

Uwagi

W przypadku kontrolek bieżący styl jest często zapewniany przez domyślny styl od kontrolowania motywów lub z stylów zwykle stosowanych do kontrolek tego typu według zasobów na poziomie strony lub aplikacji (styl niejawny). Ta właściwość nie ustawia ani nie zwraca stylów domyślnych (motywu), ale zwraca styl niejawny lub jawny styl działający na elemecie. W przypadku niejawnych lub jawnych stylów nie ma znaczenia, czy styl jest określony jako zasób, czy zdefiniowany lokalnie.

Ustawianie stylów ma pewne ograniczenia. Całą właściwość można zresetować Style do nowej Style właściwości w dowolnym momencie, co wymusi zmiana układu. Jednak gdy tylko ten styl zostanie umieszczony w użyciu przez załadowany element, Style należy je uznać za zapieczętowane. Próba wprowadzenia zmiany dowolnej właściwości stylu w użyciu (na przykład dowolnego elementu w kolekcji ) powoduje zgłoszenie wyjątku Setters. Styl zdefiniowany w znacznikach jest uznawany za używany tak szybko, jak jest ładowany ze słownika zasobów (dla zasobów) lub strony, w ramach których znajduje się (dla stylów wbudowanych).

Style jest właściwością zależności ze szczególnym pierwszeństwem. Styl zestawu lokalnego zwykle 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 nieumyślne style w zasobach lokalnych lub aplikacji określają ten typ. Jeśli styl nadal ma wartość null po tym kroku, styl działania do celów prezentacji zazwyczaj 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 lub stylu i tworzenia szablonów.

Użycie atrybutu XAML

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

Użycie elementu właściwości XAML

Wartości XAML

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

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

Informacje o właściwości zależności