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

範例

下列範例會定義將套用至每個 TextBlock 專案的 Style。 此 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 項目，當 IsPressed 屬性 true時，變更按鈕的 Foreground 屬性。

<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 屬性，setter 才能有意義。 在 .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