Поделиться через


FrameworkElement.Style Свойство

Определение

Возвращает или задает стиль, используемый этим элементом при отрисовки.

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

Значение свойства

Примененный стиль, неразрешимый для элемента, если он присутствует. В противном случае — null. Значение по умолчанию для созданного FrameworkElementnullпо умолчанию.

Примеры

В следующем примере определяется стиль в словаре ресурсов.

<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>

Комментарии

Для элементов управления текущий стиль часто предоставляется стилем по умолчанию из элементов управления или из стилей, которые обычно применяются к элементам управления этого типа по ресурсам на уровне страницы или приложения (неявный стиль). Это свойство не задает или возвращает стили по умолчанию (тема), но возвращает неявный стиль или явный стиль, действующий в элементе. В случае неявных или явных стилей не имеет значения, указывается ли стиль как ресурс или определен локально.

Настройка стилей имеет некоторые ограничения. Вы можете сбросить все Style свойство в новое Style в любое время, что приведет к перекомпозиции макета. Однако, как только этот стиль используется загруженным элементом, Style следует считать запечатанным. Попытка внести изменения в любое отдельное свойство стиля использования (например, что-либо в коллекции Setters) приводит к возникновению исключения. Стиль, определенный в разметке, считается используемым сразу после загрузки из словаря ресурсов (для ресурсов) или страницы, содержащейся в ней, загружается (для встроенных стилей).

Style — это свойство зависимостей с особым приоритетом. Локальный стиль обычно работает в наибольшей приоритете в системе свойств. Style Если значение null на этом этапе, во время загрузки системы свойств проверяет наличие неявных стилей в локальных ресурсах или ресурсах приложений, которые указывают этот тип. Если стиль по-прежнему имеет значение NULL после этого шага, то стиль действия для целей презентации обычно поступает из стиля по умолчанию (тема), но стиль по умолчанию не возвращается в значении Style свойства. См. раздел "Приоритет свойства зависимостей " или " Стилизация" и "Шаблон".

Использование атрибута XAML

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

Использование элемента свойства XAML

Значения XAML

resourceExtension Одно из следующих элементов: или . См. статью "Ресурсы XAML".

styleResourceKey Ключ, определяющий запрошенный стиль. Ключ ссылается на существующий ресурс в объекте ResourceDictionary.

Замечание

Синтаксис элемента свойства технически возможен, но не рекомендуется для большинства сценариев стиля. См. встроенные стили и шаблоны. Ссылка на привязку с помощью TemplateBinding или Binding также возможна, но редкость.

Сведения о свойстве зависимостей

Элемент Ценность
Поле идентификатора StyleProperty
Свойства метаданных, равные свойству true AffectsMeasure

Применяется к