本文章是由人工翻譯。將指標移到文章內的文字上方即可查看原文。

譯文

原文

本主題尚未接受評分 - 為這個主題評分

Setter 類別

.NET Framework 4

其他版本

表示套用屬性值的 setter。

繼承階層架構

System.Object
System.Windows.SetterBase
System.Windows.Setter

命名空間： System.Windows
組件： PresentationFramework (在 PresentationFramework.dll 中)
針對 XAML 的 XMLNS： http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

語法

C++

[XamlSetMarkupExtensionAttribute("ReceiveMarkupExtension")]
[XamlSetTypeConverterAttribute("ReceiveTypeConverter")]
public class Setter : SetterBase, ISupportInitialize

XAML 物件項目用法

<Setter .../>

Setter 型別會公開下列成員。

建構函式

	名稱	說明
	Setter()	初始化 Setter 類別的新執行個體。
	Setter(DependencyProperty, Object)	使用指定的屬性和值，初始化 Setter 類別的新執行個體。
	Setter(DependencyProperty, Object, String)	使用指定的屬性、值和目標名稱，初始化 Setter 類別的新執行個體。

回頁首

屬性

	名稱	說明
	IsSealed	取得值，這個值表示這個物件是否處於不變的狀態。 (繼承自 SetterBase)。
	Property	取得或設定將套用 Value 的屬性。
	TargetName	取得或設定這個 Setter 適用的物件名稱。
	Value	取得或設定值，這個值要套用到這個 Setter 所指定的屬性。

回頁首

方法

	名稱	說明
	CheckSealed	檢查這個物件是否為唯讀而無法變更。 (繼承自 SetterBase)。
	Equals(Object)	判斷指定的 Object 和目前的 Object 是否相等。 (繼承自 Object)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ReceiveMarkupExtension	處理標記延伸對 Setter 物件的屬性提供值的情況。
	ReceiveTypeConverter	處理型別轉換子對 Setter 物件的屬性提供值的情況。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

明確介面實作

	名稱	說明
	ISupportInitialize.BeginInit	基礎架構。表示物件正在啟動初始設定。
	ISupportInitialize.EndInit	基礎架構。表示物件已完成初始設定。

回頁首

例外狀況

例外狀況	條件
ArgumentNullException	Property 屬性不可以是 null。
ArgumentException	如果指定的 Property 是唯讀屬性。
ArgumentException	如果指定的 Value 設定為 UnsetValue。

備註

Style 和不同型別的觸發程序 (衍生自 TriggerBase 的類別) 使用 Setter 套用屬性值。

請注意，您必須在 Setter 上同時指定 Property 和 Value 屬性，setter 才有意義。如果未設定其中一個屬性或兩個屬性都未設定，則會擲回例外狀況 (Exception)。

範例

下列範例定義將套用至每個 TextBlock 項目的 Style。這個 Style 會使用 Setter 將值套用到數個 TextBlock 屬性。

XAML


<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 屬性。

XAML


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

版本資訊

.NET Framework

支援版本：4、3.5、3.0

.NET Framework Client Profile

支援版本：4、3.5 SP1

平台

Windows 7, Windows Vista SP1 (含) 以後版本, Windows XP SP3, Windows Server 2008 (不支援伺服器核心), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心), Windows Server 2003 SP2

.NET Framework 並不支援各種平台的所有版本。如需支援的版本的清單，請參閱.NET Framework 系統需求。

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

System.Windows 命名空間

EventSetter

TriggerBase

其他資源

設定樣式和範本

資料範本化概觀

本文對您有任何幫助嗎？是否

不正確

不夠深入

需要更多程式碼範例

翻譯需要加強。

(剩餘 1500 個字元)

社群新增項目

新增