FrameworkContentElement.Style Свойство

Определение

Получает или задает стиль, который должен использоваться этим элементом.Gets or sets the style to be used by this element.

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

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

Примененный стиль не по умолчанию для элемента, если присутствует.The applied, nondefault style for the element, if present. В противном случае — значение null.Otherwise, null. Значение по умолчанию для созданного по умолчанию FrameworkContentElement — null.The default for a default-constructed FrameworkContentElement is null.

Примеры

В следующем примере создается коллекция Resources для FlowDocument корневого элемента, а затем она ссылается на него как на конкретный стиль для Paragraph.The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a 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>

Комментарии

Текущий стиль часто предоставляется стилем по умолчанию или из стилей, обычно применяемых к объектам этого типа по ресурсам на уровне страницы или приложения (неявный стиль).The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Это свойство не устанавливает или не возвращает стили по умолчанию (темы), но возвращает неявный стиль или явный стиль.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. В случае явных или неявных стилей не имеет значения, доступен ли стиль как ресурс или определен локально.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

Установка стилей имеет некоторые ограничения.Setting the styles has some restrictions. Можно сбросить все Style свойства в новое Style в любое время, что приведет к перекомпоновке макета.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Однако, как только этот стиль будет помещен в элемент, используемый загруженным элементом, Style следует считать запечатанным.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Попытка изменить любое отдельное свойство используемого стиля (например, что-либо в коллекции Setters) приводит к возникновению исключения.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. Стиль, определенный в разметке, считается используемым, как только он загружается из словаря ресурсов (для ресурсов), или загружается страница, содержащаяся в загрузкой (для встроенных стилей).A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Style — это свойство зависимостей с особым приоритетом.Style is a dependency property with special precedence. Локально заданный стиль обычно работает с наивысшим приоритетом в системе свойств.The locally set style generally operates at the highest precedence in the property system. Если на этом этапе Style имеет значение null, при загрузке системы свойств для неявных стилей в качестве определенных ресурсов, указывающих этот тип, происходит проверка.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Если после этого шага стиль по-прежнему имеет значение null, то стиль берется из стиля по умолчанию (темы), но стиль по умолчанию не возвращается в значении свойства Style.If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. См. раздел Приоритет значения свойства зависимостей.See Dependency Property Value Precedence.

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

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

Значения XAMLXAML Values

ресаурцеекстенсионresourceExtension
Один из следующих элементов: или.One of the following: , or . См. раздел ресурсы XAML.See XAML Resources.

стилересаурцекэйstyleResourceKey
Ключ, определяющий запрашиваемый стиль.The key that identifies the style being requested. Ключ ссылается на существующий ресурс в ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Примечание

Синтаксис элемента свойства технически возможен, но не рекомендуется.Property element syntax is technically possible, but not recommended. См. раздел встроенные стили и шаблоны.See Inline Styles and Templates. Ссылка на привязку с помощью TemplateBinding или Binding также возможна, но не часто.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

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

Поле идентификатораIdentifier field StyleProperty
Для свойств метаданных задано значение trueMetadata properties set to true AffectsMeasure

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