FrameworkContentElement.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。 对于默认构造的 FrameworkContentElement,其默认值为 null

示例

以下示例在根元素上建立一个ResourcesFlowDocument集合,然后将其作为资源作为特定样式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 返回默认样式。 请参阅 Dependency 属性值优先级

XAML 属性用法

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

XAML 值

resourceExtension
下列项之一:或。 请参阅 XAML 资源

styleResourceKey
标识所请求样式的键。 该键是指在一个 ResourceDictionary. 中存在的资源。

备注

属性元素语法在技术上是可能的,但不建议这样做。 请参阅 内联样式和模板。 使用 TemplateBindingBinding 绑定引用,也可能是罕见的。

依赖项属性信息

标识符字段 StyleProperty
元数据属性设置为 true AffectsMeasure

适用于