FrameworkContentElement.Style Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

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

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. Значение по умолчанию для созданного FrameworkContentElementnullпо умолчанию.

Примеры

Следующий пример устанавливает Resources коллекцию в корневом FlowDocument элементе, а затем ссылается на нее как ресурс в качестве определенного стиля.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>

Комментарии

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

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

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

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

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

Значения XAML

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

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

Замечание

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

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

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