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 多個 TextBlock 屬性 Setter使用 s 的值。

<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>

以下範例顯示一個 Style 可 Button 被控制項使用的名字。 定義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的類別）使用 SetterS 來套用屬性值。

你必須在 a Setter 上同時指定 和 PropertyValue 屬性，讓 setter 有意義。 在 .NET 8 和舊版中，如果未設定一或兩個屬性，則會擲回例外狀況。

內容模式： 在 .NET 9 及更新版本中，內容 Setter 屬性為 Value，且可選擇指定 Value 為屬性。

建構函式

名稱	Description
Setter()	初始化 Setter 類別的新執行個體。
Setter(DependencyProperty, Object, String)	初始化一個具有指定屬性、值及目標名稱的 Setter 類別新實例。
Setter(DependencyProperty, Object)	初始化一個具有指定屬性與值的新 Setter 類別實例。

屬性

名稱	Description
IsSealed	取得值，這個值表示這個物件是否處於不可變的狀態。 (繼承來源 SetterBase)
Property	取得或設定將應用於該 Value 屬性的屬性。
TargetName	取得或設定此物件 Setter 的名稱。
Value	取得或設定值以應用於由此 Setter指定的屬性。

方法

名稱	Description
CheckSealed()	檢查此物件是否為唯讀且無法變更。 (繼承來源 SetterBase)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	處理標記擴充提供物件屬性 Setter 值的情況。
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	處理型別轉換器提供物件屬性 Setter 值的情況。

明確介面實作

名稱	Description
ISupportInitialize.BeginInit()	發出初始化正在啟動的物件訊號。
ISupportInitialize.EndInit()	向對象發出初始化完成的訊號。

另請參閱

• EventSetter
• TriggerBase