Trigger Klasse

Definition

Stellt einen Trigger dar, der Eigenschaftswerte anwendet oder Aktionen bedingt ausführt.Represents a trigger that applies property values or performs actions conditionally.

public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, 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
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird ein mit Style dem Namen Button verfügbar für-Steuerelemente angezeigt.The following example shows a named Style available to Button controls. true IsPressed Definiert ein Trigger -Element, das die Foreground -Eigenschaft einer Schaltfläche ändert, wenn die-Eigenschaft ist. StyleThe 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>

Hinweise

WPFWPFdefiniert Eigenschaften, die Endbenutzer Aktionen entsprechen, wie z. b IsMouseOver . die-Eigenschaft, true die auf festgelegt wird, wenn der Benutzer UIElement den Cursor über IsMouseOver eine oder die ContentElemententsprechende-Eigenschaft eines bewegt.defines properties that correspond to end-user actions, such as the IsMouseOver property that is set to true when the user hovers the cursor over a UIElement or the corresponding IsMouseOver property of a ContentElement. Durch das darstellen von Endbenutzer Aktionen in Eigenschafts Werten, Trigger zusammen mit dem WPFWPF -Element, können Stile Eigenschaftswerte auf Grundlage dieser Endbenutzer Aktionen ändern.Representing end-user actions in property values, along with the Trigger element, allows WPFWPF styles to change property values based on those end-user actions, all from within markup.

Die Eigenschaften, die von Triggern geändert werden, werden automatisch auf Ihren vorherigen Wert zurückgesetzt, wenn die ausgelöste Bedingung nicht mehr erfüllt ist.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. Trigger sind für vorübergehende Zustände optimiert, die erwartungsgemäß geändert und zum ursprünglichen Zustand zurückkehren, wie IsPressed z Button . b ListBoxItem. on und IsSelected on.Triggers are optimized for transient states which are expected to change and return to original state, such as IsPressed on Button and IsSelected on ListBoxItem. Der Property von Interesse muss eine Abhängigkeits Eigenschaft sein.The Property of interest must be a dependency property.

Beachten Sie, dass Sie sowohl die Property - Value Eigenschaft als auch Trigger die-Eigenschaft für einen angeben müssen, damit der-Wert sinnvoll istNote that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Wenn eine oder beide Eigenschaften nicht festgelegt sind, wird eine Ausnahme ausgelöst.If one or both of the properties are not set, an exception is thrown.

Die Setters -Eigenschaft Trigger eines- Setter Objekts kann nur aus-Objekten bestehen.The Setters property of a Trigger object can only consist of Setter objects. Wenn Sie Setter einem- Trigger Objekt ein untergeordnetes Element hinzufügen SetterBaseCollection , wird Trigger dieses implizit dem für das-Objekt hinzugefügtAdding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetterObjekte werden nicht unterstützt. unter Style.Setters stütztEventSetter nur-Objekte.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Es gibt andere Arten von Triggern.There are other types of triggers. MultiTriggerermöglicht das Anwenden von Änderungen auf der Grundlage des Status von mehreren Eigenschaften.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTriggerermöglicht das Anwenden von Änderungen, wenn ein Ereignis auftritt.EventTrigger allows you to apply changes when an event occurs. DataTriggerund MultiDataTrigger sind für Daten gebundene Eigenschaften.DataTrigger and MultiDataTrigger are for data-bound properties.

Konstruktoren

Trigger()

Initialisiert eine neue Instanz der Trigger-Klasse.Initializes a new instance of the Trigger class.

Eigenschaften

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
EnterActions

Ruft eine Auflistung von TriggerAction-Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt aktiviert wird.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Diese Eigenschaft gilt nicht für die EventTrigger-Klasse.This property does not apply to the EventTrigger class.

(Geerbt von TriggerBase)
ExitActions

Ruft eine Auflistung von TriggerAction-Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt deaktiviert wird.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Diese Eigenschaft gilt nicht für die EventTrigger-Klasse.This property does not apply to the EventTrigger class.

(Geerbt von TriggerBase)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(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.Gets or sets the property that returns the value that is compared with the Value property of the trigger. Der Vergleich ist eine Verweisgleichheitsprüfung.The comparison is a reference equality check.

Setters

Ruft eine Auflistung von Setter-Objekten ab, die die Eigenschaftswerte beschreiben, die angewendet werden sollen, wenn die angegebene Bedingung erfüllt wird.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName

Ruft den Namen des Objekts mit der Eigenschaft ab, durch die die zugeordneten Setter angewendet werden, oder legt diesen fest.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value

Ruft den Wert ab, der mit dem Eigenschaftswert des Elements verglichen werden soll, oder legt diesen fest.Gets or sets the value to be compared with the property value of the element. Der Vergleich ist eine Verweisgleichheitsprüfung.The comparison is a reference equality check.

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Behandelt Fälle, in denen ein Typkonverter einen Wert für die Eigenschaft eines Trigger-Objekts bereitstellt.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)

Fügt ein untergeordnetes Objekt hinzu.Adds a child object.

IAddChild.AddText(String)

Fügt dem Objekt den Textinhalt eines Knotens hinzu.Adds the text content of a node to the object.

ISupportInitialize.BeginInit()

Signalisiert dem Objekt den Start der Initialisierung.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

Signalisiert dem Objekt den Abschluss der Initialisierung.Signals the object that initialization is complete.

Gilt für:

Siehe auch