Udostępnij za pośrednictwem


FrameworkElement.Style Właściwość

Definicja

Pobiera lub ustawia styl używany przez ten element podczas jego renderowania.

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

Style

Zastosowany, nieokreślony styl elementu, jeśli istnieje. W przeciwnym razie wartość null. Wartością domyślną dla konstrukcji FrameworkElement domyślnej jest 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 styl domyślny z motywów sterujących lub style zwykle stosowane do kontrolek 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 styl niejawny lub jawny styl, który działa 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 go uznać za zapieczętowany. 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ą niejawne style w zasobach lokalnych lub aplikacji, które 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 styli i szablonów.

Użycie atrybutu języka XAML

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

Użycie elementu właściwości języka XAML

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 w przypadku większości scenariuszy stylu. 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