Setter 类

定义

命名空间:

System.Windows

程序集:

PresentationFramework.dll

表示应用属性值的 setter。

public ref class Setter : System::Windows::SetterBase, System::ComponentModel::ISupportInitialize

[System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Setter : System.Windows.SetterBase, System.ComponentModel.ISupportInitialize

[<System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Setter = class
    inherit SetterBase
    interface ISupportInitialize

Public Class Setter
Inherits SetterBase
Implements ISupportInitialize

继承

Object

SetterBase

Setter

属性

XamlSetMarkupExtensionAttribute XamlSetTypeConverterAttribute

实现

ISupportInitialize

示例

以下示例定义 Style 将应用于每个元素的 TextBlock 。 这Style会将值应用于使用 Setter的多个TextBlock属性。

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

以下示例演示可用于Button控件的命名 Style 。 定义Style一个Trigger元素，Foreground该元素在 属性为 true时更改按钮的 IsPressed 属性。

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

注解

Style和不同类型的触发器 (继承自 TriggerBase) 的类使用 Setter应用属性值。

您必须在 上Setter指定 Property 和 Value 属性，资源库才能有意义。 在 .NET 8 及更早版本中，如果未设置一个或两个属性，则会引发异常。

内容模型： 在 .NET 9 及更高版本中，的内容 Setter 属性为 Value，可以选择将 指定 Value 为属性。

构造函数

Setter()	初始化 Setter 类的新实例。
Setter(DependencyProperty, Object)	用指定的属性和值初始化 Setter 类的新实例。
Setter(DependencyProperty, Object, String)	用指定的属性、值和目标名称初始化 Setter 类的新实例。

属性

IsSealed	获取一个值，该值指示此对象是否为不可变状态。 (继承自 SetterBase)
Property	获取或设置要应用 Value 的属性。
TargetName	获取或设置此 Setter 所用于的对象的名称。
Value	获取或设置要应用于此 Setter 所指定的属性的值。

方法

CheckSealed()	检查此对象是否为只读且无法更改。 (继承自 SetterBase)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	处理标记扩展为 Setter 对象的属性提供值的情况。
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	处理类型转换器为 Setter 对象的属性提供值的情况。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ISupportInitialize.BeginInit()	用信号通知对象初始化即将开始。
ISupportInitialize.EndInit()	用信号通知对象初始化已完成。

另请参阅

• EventSetter
• TriggerBase