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

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

Style

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

Примеры

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

<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

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