Trigger Klasse

Definition

Stellt einen Trigger dar, der Eigenschaftswerte anwendet oder bedingt Aktionen ausführt.

public ref class Trigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild
public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Setters")]
public class Trigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild
[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Trigger : System.Windows.TriggerBase, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IAddChild
[<System.Windows.Markup.ContentProperty("Setters")>]
type Trigger = class
    inherit TriggerBase
    interface IAddChild
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface IAddChild
Public Class Trigger
Inherits TriggerBase
Implements IAddChild
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Vererbung
Attribute
Implementiert

Beispiele

Das folgende Beispiel zeigt einen benannten, Style der für Steuerelemente verfügbar ist Button . Style Definiert ein Trigger -Element, das die Foreground -Eigenschaft einer Schaltfläche ändert, wenn die IsPressed -Eigenschaft isttrue.

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

Hinweise

WPF definiert Eigenschaften, die Endbenutzeraktionen entsprechen, z. B. die Eigenschaft, die IsMouseOver auf true festgelegt wird, wenn der Benutzer den Cursor über eine UIElement oder die entsprechende IsMouseOver Eigenschaft eines ContentElementbewegt. Die Darstellung von Endbenutzeraktionen in Eigenschaftswerten zusammen mit dem Trigger -Element ermöglicht es WPF-Stilen, Eigenschaftswerte basierend auf diesen Endbenutzeraktionen zu ändern, alles innerhalb des Markups.

Die von Triggern geänderten Eigenschaften werden automatisch auf ihren vorherigen Wert zurückgesetzt, wenn die ausgelöste Bedingung nicht mehr erfüllt ist. Trigger sind für vorübergehende Zustände optimiert, von denen erwartet wird, dass sie sich ändern und in den ursprünglichen Zustand zurückkehren, z IsPressed . B. für Button und IsSelected für ListBoxItem. Das Property von Interesse muss eine Abhängigkeitseigenschaft sein.

Beachten Sie, dass Sie sowohl die Property Eigenschaften als Value auch für eine Trigger angeben müssen, damit der Trigger sinnvoll ist. Wenn eine oder beide Eigenschaften nicht festgelegt sind, wird eine Ausnahme ausgelöst.

Die Setters -Eigenschaft eines Trigger -Objekts kann nur aus Setter -Objekten bestehen. Beim Hinzufügen eines Setter untergeordneten Elements zu einem Trigger Objekt wird es implizit dem SetterBaseCollection für das Trigger -Objekt hinzugefügt. EventSetter-Objekte werden nicht unterstützt. unterstützt EventSetter nur Style.Setters -Objekte.

Es gibt andere Arten von Triggern. MultiTrigger ermöglicht das Anwenden von Änderungen basierend auf dem Status mehrerer Eigenschaften. EventTrigger ermöglicht das Anwenden von Änderungen, wenn ein Ereignis auftritt. DataTrigger und MultiDataTrigger gelten für datengebundene Eigenschaften.

Konstruktoren

Trigger()

Initialisiert eine neue Instanz der Trigger-Klasse.

Eigenschaften

DependencyObjectType

Ruft den ab, der DependencyObjectType den CLR-Typ dieser Instanz umschließt.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
EnterActions

Ruft eine Auflistung von TriggerAction-Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt aktiviert wird. Diese Eigenschaft gilt nicht für die EventTrigger-Klasse.

(Geerbt von TriggerBase)
ExitActions

Ruft eine Auflistung von TriggerAction-Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt deaktiviert wird. Diese Eigenschaft gilt nicht für die EventTrigger-Klasse.

(Geerbt von TriggerBase)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.

(Geerbt von DependencyObject)
Property

Ruft die Eigenschaft ab, die den Wert zurückgibt, der mit der Value-Eigenschaft des Triggers verglichen wird, oder legt diese Eigenschaft fest. Der Vergleich ist eine Verweisgleichheitsprüfung.

Setters

Ruft eine Auflistung von Setter-Objekten ab, die die Eigenschaftswerte beschreiben, die angewendet werden sollen, wenn die angegebene Bedingung erfüllt wird.

SourceName

Ruft den Namen des Objekts mit der Eigenschaft ab, durch die die zugeordneten Setter angewendet werden, oder legt diesen fest.

Value

Ruft den Wert ab, der mit dem Eigenschaftswert des Elements verglichen werden soll, oder legt diesen fest. Der Vergleich ist eine Verweisgleichheitsprüfung.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.

(Geerbt von DependencyObject)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.

(Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.

(Geerbt von DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Behandelt Fälle, in denen ein Typkonverter einen Wert für die Eigenschaft eines Trigger-Objekts bereitstellt.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.

(Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.

(Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)

Fügt ein untergeordnetes Objekt hinzu.

IAddChild.AddText(String)

Fügt dem Objekt den Textinhalt eines Knotens hinzu.

ISupportInitialize.BeginInit()

Signalisiert dem Objekt den Start der Initialisierung.

ISupportInitialize.EndInit()

Signalisiert dem Objekt den Abschluss der Initialisierung.

Gilt für

Siehe auch