Setter クラス

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

プロパティ値を適用するセッターを表します。

C#

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

継承

Object

SetterBase

Setter

属性

XamlSetMarkupExtensionAttribute XamlSetTypeConverterAttribute

実装

ISupportInitialize

例

次の例では、すべての 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 は、IsPressed プロパティが trueされたときにボタンの Foreground プロパティを変更する Trigger 要素を定義します。

XAML

<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