FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style FrameworkElement.Style Property

Определение

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

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. Значение по умолчанию для созданного по умолчанию FrameworkElementnull.The default for a default-constructed FrameworkElement is null.

Примеры

В следующем примере определяется стиль в словаре ресурсов.The following example defines a style in a resource dictionary.

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

Комментарии

Для элементов управления текущий стиль часто предоставляемые стиль по умолчанию из темы элементов управления или из стилей обычно применяется к элементам управления этого типа ресурсами на уровне страницы или приложения (неявный стиль).For controls, the current style is often provided by a default style from control theming, or from styles generally applied to controls 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 either an implicit style or an explicit style that is acting on the element. В случае явного или неявного стили неважно ли стиль задается как ресурс или определенные локально.In the case of implicit or explicit styles, it does not matter whether the style is specified 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 in local or application resources that specify that type. Если стиль равен null после выполнения этого шага, то действующий стиль для целей представления обычно поступает из стиля по умолчанию (тема), но стиль по умолчанию не возвращается в Style значение свойства.If the style is still null after this step, then the acting style for presentation purposes generally comes from the default (theme) style, but the default style is not returned in the Style property value. См. в разделе приоритет значений свойств зависимостей или Стилизация и использование шаблонов.See Dependency Property Value Precedence or Styling and Templating.

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

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

Использование элемента свойства XAMLXAML Property Element Usage

Значения XAMLXAML Values

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

styleResourceKeystyleResourceKey
Ключ, который идентифицирует запрашиваемый стиль.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 for most style scenarios. См. в разделе встроенные стили и шаблоны.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

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