Trigger.Property Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

[AmbientAttribute]
[LocalizabilityAttribute(LocalizationCategory.None, Modifiability = Modifiability.Unmodifiable, 
	Readability = Readability.Unreadable)]
public DependencyProperty Property { get; set; }

Property Value

Type: System.Windows.DependencyProperty

A DependencyProperty that returns the property value of the element. The default value is null.

Exception Condition
ArgumentException

A Style cannot contain a Trigger that refers to the Style property.

InvalidOperationException

After a Trigger is in use, it cannot be modified.

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. If the two values match, then the associated Setters apply the specified property values.

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.

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.

The following example contains two triggers. The first changes the Background property of a Button when the IsMouseOver property is true. The second changes the Foreground property of a button when the IsPressed property is true. 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">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

.NET Framework
Available since 3.0
Return to top
Show: