Trigger.Property プロパティ


トリガーの Value プロパティと比較される値を返すプロパティを取得または設定します。Gets or sets the property that returns the value that is compared with the Value property of the trigger. この比較は参照の等価性チェックです。The comparison is a reference equality check.

 property System::Windows::DependencyProperty ^ Property { System::Windows::DependencyProperty ^ get(); void set(System::Windows::DependencyProperty ^ value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Modifiability=System.Windows.Modifiability.Unmodifiable, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.DependencyProperty Property { get; set; }
member this.Property : System.Windows.DependencyProperty with get, set
Public Property Property As DependencyProperty



要素のプロパティ値を返す DependencyPropertyA DependencyProperty that returns the property value of the element. 既定値は nullにする必要があります。The default value is null.



Style に、Trigger プロパティを参照する Style を含めることはできません。A Style cannot contain a Trigger that refers to the Style property.

Trigger は、使用中には変更できません。After a Trigger is in use, it cannot be modified.

次の例には、2つのトリガーが含まれています。The following example contains two triggers. 最初のは、IsMouseOver プロパティが trueされている場合に、ButtonBackground プロパティを変更します。The first changes the Background property of a Button when the IsMouseOver property is true. 2番目のプロパティは、IsPressed プロパティが true場合に、ボタンの Foreground プロパティを変更します。The second changes the Foreground property of a button when the IsPressed property is true. StyleTargetTypeButton に設定されているため、Property プロパティをクラス名で修飾する必要はありません。The TargetType of the Style is set to Button and therefore there is no need to qualify the Property properties with the class name.

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


このプロパティによって返される値は、Value プロパティによって指定された値と比較されます。The value returned by this property is compared with the value specified by the Value property. 実行される比較は、参照の等価性のチェックです。The comparison that is performed is a reference equality check. 2つの値が一致する場合、関連付けられている Setters は、指定されたプロパティ値を適用します。If the two values match, then the associated Setters apply the specified property values.

このトリガーを含むスタイルまたはテンプレートに TargetType プロパティが設定されていない場合は、ClassName.PropertyName 構文を使用して、指定するプロパティを修飾します。Use the ClassName.PropertyName syntax to qualify the property you are specifying if the style or template that contains this trigger does not have the TargetType property set.

トリガーを意味のあるものにするには、TriggerPropertyValue の両方のプロパティを指定する必要があることに注意してください。Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. プロパティの一方または両方が設定されていない場合は、例外がスローされます。If one or both of the properties are not set, an exception is thrown.