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

Примеры

Следующий пример устанавливает коллекцию 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

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