Setter Class
Represents a setter that applies a property value.
Namespace: System.Windows
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
The Setter type exposes the following members.
| Name | Description | |
|---|---|---|
 | Setter() | Initializes a new instance of the Setter class. |
| Setter(DependencyProperty, Object) | Initializes a new instance of the Setter class with the specified property and value. |
| Setter(DependencyProperty, Object, String) | Initializes a new instance of the Setter class with the specified property, value, and target name. |
| Name | Description | |
|---|---|---|
| IsSealed | Gets a value that indicates whether this object is in an immutable state. (Inherited from SetterBase.) |
| Property | Gets or sets the property to which the Value will be applied. |
| TargetName | Gets or sets the name of the object this Setter is intended for. |
| Value | Gets or sets the value to apply to the property that is specified by this Setter. |
| Name | Description | |
|---|---|---|
| CheckSealed | Checks whether this object is read-only and cannot be changed. (Inherited from SetterBase.) |
| Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ReceiveMarkupExtension | Handles cases where a markup extension provides a value for a property of Setter object. |
| ReceiveTypeConverter | Handles cases where a type converter provides a value for a property of a Setter object. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
| ISupportInitialize.BeginInit | Infrastructure. Signals the object that initialization is starting. |
| ISupportInitialize.EndInit | Infrastructure. Signals the object that initialization is complete. |
| Exception | Condition |
|---|---|
| ArgumentNullException | The Property property cannot be null. |
| ArgumentException | If the specified Property is a read-only property. |
| ArgumentException | If the specified Value is set to UnsetValue. |
Styles and the different types of triggers (classes that inherit from TriggerBase) use Setters to apply property values.
Note that you must specify both the Property and Value properties on a Setter for the setter to be meaningful. If one or both properties are not set, an exception will be thrown.
The following example defines a Style that will be applied to every TextBlock element. This Style applies values to several TextBlock properties with the use of Setters.
<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>
The following example shows a named Style available to Button controls. The Style defines a Trigger element that 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>
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
