Setter.Value Eigenschaft

Definition

Ruft den Wert ab, der auf die von diesem Setter angegebene Eigenschaft angewendet werden soll, oder legt diesen Wert fest.Gets or sets the value to apply to the property that is specified by this Setter.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Markup.SetterTriggerConditionValueConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.DependsOn("Property")]
[System.Windows.Markup.DependsOn("TargetName")]
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

Eigenschaftswert

Der Standardwert ist UnsetValuesein.The default value is UnsetValue.

Attribute

Ausnahmen

Wenn der angegebene Value auf UnsetValue festgelegt ist.If the specified Value is set to UnsetValue.

Beispiele

Im folgenden Beispiel wird ein Style -Element definiert, das auf TextBlock jedes Element angewendet wird.The following example defines a Style that will be applied to every TextBlock element. Das komplette Beispiel finden Sie unter Einführung indas Erstellen von Formaten und Vorlagen.For the complete example, see Introduction to Styling and Templating Sample.

<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>

Im folgenden Beispiel wird ein Style - SetterWert mit s definiert, die auf Systemressourcen verweisen.The following example defines a Style with Setters that reference system resources.

<Style x:Key="SystemResStyle" TargetType="{x:Type Button}">
    <Setter Property = "Background" Value= 
                       "{DynamicResource {x:Static SystemColors.ControlLightBrushKey}}"/>
    <Setter Property = "Foreground" Value= 
                       "{DynamicResource {x:Static SystemColors.ControlDarkBrushKey}}"/>
    <Setter Property = "FontSize" Value= 
                       "{DynamicResource {x:Static SystemFonts.IconFontSizeKey}}"/>
    <Setter Property = "FontWeight" Value= 
                       "{DynamicResource {x:Static SystemFonts.MessageFontWeightKey}}"/>
    <Setter Property = "FontFamily" Value= 
                       "{DynamicResource {x:Static SystemFonts.CaptionFontFamilyKey}}"/>
</Style>

Im folgenden Beispiel wird ein Style für die RepeatButtondefiniert.The following example defines a Style for the RepeatButton.

<Style x:Key="Slider_Thumb" TargetType="{x:Type Thumb}">
    <Setter Property="OverridesDefaultStyle" Value="true" />
    <Setter Property="Width" Value="14" />
    <Setter Property="Height" Value="14" />
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type Thumb}">
                <Grid Width="14" Height="14">
                    <Ellipse Fill="{TemplateBinding Foreground}" />
                    <Ellipse Stroke="{TemplateBinding BorderBrush}" StrokeThickness="1" x:Name="ThumbCover" >
                        <Ellipse.Fill>
                            <LinearGradientBrush  EndPoint="0,1" StartPoint="0,0">
                                <LinearGradientBrush.GradientStops>
                                    <GradientStop Color="#CCFFFFFF" Offset="0" />
                                    <GradientStop Color="#00000000" Offset=".5" />
                                    <GradientStop Color="#66000000" Offset="1" />
                                </LinearGradientBrush.GradientStops>
                            </LinearGradientBrush>
                        </Ellipse.Fill>
                    </Ellipse>
                </Grid>
                <ControlTemplate.Triggers>
                    <Trigger Property="IsDragging" Value="true">
                        <Setter TargetName="ThumbCover" Property="Fill">
                            <Setter.Value>
                                <LinearGradientBrush  EndPoint="0,1" StartPoint="0,0">
                                    <LinearGradientBrush.GradientStops>
                                        <GradientStop Color="#CCFFFFFF" Offset="1" />
                                        <GradientStop Color="#00000000" Offset=".5" />
                                        <GradientStop Color="#66000000" Offset="0" />
                                    </LinearGradientBrush.GradientStops>
                                </LinearGradientBrush>
                            </Setter.Value>
                        </Setter>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

Das folgende Beispiel zeigt eine Value Eigenschaft, die die Binding -Deklaration verwendet.The following example shows a Value property that uses the Binding declaration. Das vollständige Beispiel finden Sie unter Beispiel für Bindungsvalidierung.For the complete example, see Binding Validation Sample.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Hinweise

Verwendung von XAML-AttributenXAML Attribute Usage

<object Value="value"/>  

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

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

XAML-WerteXAML Values

valuevalue
Ein-Objekt oder eine Markup Erweiterung.An object or a markup extension. Siehe statikresource-Markup Erweiterung.See StaticResource Markup Extension.

Beachten Sie, dass Sie sowohl die Property - Value als auch die Setter -Eigenschaft für einen angeben müssen, oder es wird eine Ausnahme ausgelöst.Note that you must specify both the Property and Value properties on a Setter or an exception will be thrown.

Die Datenbindung und dynamische Ressourcen innerhalb des-Objekts werden unterstützt, wenn der Freezable angegebene Wert ein-Objekt ist.Data binding and dynamic resources within the object is supported if the specified value is a Freezable object. Weitere Informationen finden Sie unter Bindungs Markup Erweiterung und dynamikresource-Markup Erweiterung.See Binding Markup Extension and DynamicResource Markup Extension.

Gilt für:

Siehe auch