Setter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Setter dar, der einen Eigenschaftswert anwendet.
public ref class Setter : System::Windows::SetterBase
public ref class Setter : System::Windows::SetterBase, System::ComponentModel::ISupportInitialize
public class Setter : System.Windows.SetterBase
[System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Setter : System.Windows.SetterBase, System.ComponentModel.ISupportInitialize
type Setter = class
inherit SetterBase
[<System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Setter = class
inherit SetterBase
interface ISupportInitialize
Public Class Setter
Inherits SetterBase
Public Class Setter
Inherits SetterBase
Implements ISupportInitialize
- Vererbung
- Attribute
- Implementiert
Beispiele
Im folgenden Beispiel wird ein Style Element definiert, das auf jedes TextBlock Element angewendet wird. Dies Style wendet Werte auf mehrere TextBlock Eigenschaften mit der Verwendung von Setters an.
<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>
Das folgende Beispiel zeigt einen Benannten, Style der für Button Steuerelemente verfügbar ist. Das Style definiert ein Trigger Element, das die Foreground Eigenschaft einer Schaltfläche ändert, wenn die IsPressed Eigenschaft lautet true.
<Style x:Key="Triggers" TargetType="Button">
<Style.Triggers>
<Trigger Property="IsPressed" Value="true">
<Setter Property = "Foreground" Value="Green"/>
</Trigger>
</Style.Triggers>
</Style>
Hinweise
Styles und die verschiedenen Arten von Triggern (Klassen, die von TriggerBase) erben, verwenden Setters, um Eigenschaftswerte anzuwenden.
Sie müssen sowohl die Eigenschaften als Value auch die Property Eigenschaften eines Setter Setters angeben, damit der Setter aussagekräftig ist. In .NET 8 und früheren Versionen wird eine Ausnahme ausgelöst, wenn eine oder beide Eigenschaften nicht festgelegt sind.
Inhaltsmodell: In .NET 9 und höheren Versionen ist Valuedie Inhaltseigenschaft für Setter sie optional, um sie als Attribut anzugebenValue.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Setter() |
Initialisiert eine neue Instanz der Setter-Klasse. |
| Setter(DependencyProperty, Object, String) |
Initialisiert eine neue Instanz der Setter Klasse mit der angegebenen Eigenschaft, dem Wert und dem Zielnamen. |
| Setter(DependencyProperty, Object) |
Initialisiert eine neue Instanz der Setter Klasse mit der angegebenen Eigenschaft und dem angegebenen Wert. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| IsSealed |
Ruft einen Wert ab, der angibt, ob sich dieses Objekt in einem unveränderlichen Zustand befindet. (Geerbt von SetterBase) |
| Property |
Ruft die Eigenschaft ab, auf die die Eigenschaft angewendet wird, oder legt sie Value fest. |
| TargetName |
Dient zum Abrufen oder Festlegen des Namens des Objekts, für das dies Setter vorgesehen ist. |
| Value |
Dient zum Abrufen oder Festlegen des Werts, der auf die Eigenschaft angewendet werden soll, die von diesem Setterangegeben wird. |
Methoden
| Name | Beschreibung |
|---|---|
| CheckSealed() |
Überprüft, ob dieses Objekt schreibgeschützt ist und nicht geändert werden kann. (Geerbt von SetterBase) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs) |
Behandelt Fälle, in denen eine Markuperweiterung einen Wert für eine Eigenschaft des Setter Objekts bereitstellt. |
| ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) |
Behandelt Fälle, in denen ein Typkonverter einen Wert für eine Eigenschaft eines Setter Objekts bereitstellt. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ISupportInitialize.BeginInit() |
Signalisiert das Objekt, das initialisiert wird. |
| ISupportInitialize.EndInit() |
Signalisiert das Objekt, dass die Initialisierung abgeschlossen ist. |