FrameworkContentElement.Style 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置此元素要使用的样式。
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
属性值
若存在,则为此元素适用的非默认样式。 否则为 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. 中存在的资源。
备注
属性元素语法在技术上是可能的,但不建议这样做。 请参阅 内联样式和模板。 使用 TemplateBinding 的 Binding 绑定引用,也可能是罕见的。
依赖项属性信息
标识符字段 | StyleProperty |
元数据属性设置为 true |
AffectsMeasure |