Trigger.Value Property

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the value to be compared with the property value of the element. The comparison is a reference equality check.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.DependsOn("Property")]
[System.Windows.Markup.DependsOn("SourceName")]
public object Value { get; set; }

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.DependsOn("Property")]
[System.Windows.Markup.DependsOn("SourceName")]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Markup.SetterTriggerConditionValueConverter))]
public object Value { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.DependsOn("Property")>]
[<System.Windows.Markup.DependsOn("SourceName")>]
member this.Value : obj with get, set

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.DependsOn("Property")>]
[<System.Windows.Markup.DependsOn("SourceName")>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Markup.SetterTriggerConditionValueConverter))>]
member this.Value : obj with get, set

Public Property Value As Object

Property Value

Object

The default value is null. See also the Exceptions section.

Attributes: LocalizabilityAttribute DependsOnAttribute TypeConverterAttribute

Exceptions

ArgumentException

Expressions such as bindings are not supported.

InvalidOperationException

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

Examples

The following example changes the Foreground property of a button when the IsPressed property is true.

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

Remarks

This value is compared with the property value returned by the Property property of the Trigger. The comparison that is performed is a reference quality check. If the two values are equal, then the associated Setters apply the specified property values.

Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Therefore, if one or both of the properties are not specified, then an exception is thrown.

XAML Property Element Usage

<object>  
  <object.Value>  
    Value  
  </object.Value>  
</object>

Applies to