Trigger Class

Definition

Stellt einen Trigger dar, der Eigenschaftswerte anwendet oder bedingt Aktionen 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
public ref 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")]
public class Trigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface IAddChild
type Trigger = class
    inherit TriggerBase
    interface IAddChild
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild
Inheritance
Attributes
Implements

Examples

Das folgende Beispiel zeigt ein benanntes Style, das für Button Steuerelemente verfügbar ist.The following example shows a named Style available to Button controls. Die Style definiert ein Trigger Element, das die Foreground-Eigenschaft einer Schaltfläche ändert, wenn die IsPressed-Eigenschaft trueist.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>

Remarks

WPFWPF definiert Eigenschaften, die Endbenutzer Aktionen entsprechen, wie z. b. die IsMouseOver-Eigenschaft, die auf true festgelegt wird, wenn der Benutzer den Cursor über eine UIElement oder die entsprechende IsMouseOver-Eigenschaft eines ContentElementbewegt.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, zusammen mit dem Trigger-Element, können WPFWPF Stile Eigenschaftswerte basierend auf diesen Endbenutzer Aktionen ändern, die sich alle im Markup befinden.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 in den ursprünglichen Zustand zurückversetzt werden, wie z. b. IsPressed auf Button und IsSelected auf ListBoxItem.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. Die Property von Interesse muss eine Abhängigkeits Eigenschaft sein.The Property of interest must be a dependency property.

Beachten Sie, dass Sie die Eigenschaften Property und Value für einen Trigger angeben müssen, damit der-Wert sinnvoll ist.Note 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 eines Trigger-Objekts kann nur aus Setter-Objekten bestehen.The Setters property of a Trigger object can only consist of Setter objects. Durch das Hinzufügen eines untergeordneten Setter zu einem Trigger-Objekt wird es implizit dem SetterBaseCollection für das Trigger Objekt hinzugefügt.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter Objekte werden nicht unterstützt. nur Style.Setters unterstützt EventSetter Objekte.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Es gibt andere Arten von Triggern.There are other types of triggers. MultiTrigger ermö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. EventTrigger ermöglicht das Anwenden von Änderungen, wenn ein Ereignis auftritt.EventTrigger allows you to apply changes when an event occurs. DataTrigger und MultiDataTrigger sind für Daten gebundene Eigenschaften.DataTrigger and MultiDataTrigger are for data-bound properties.

Constructors

Trigger()

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

Properties

DependencyObjectType

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

(Inherited from DependencyObject)
Dispatcher

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

(Inherited from 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.

(Inherited from 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.

(Inherited from 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).

(Inherited from 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.

Methods

CheckAccess()

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

(Inherited from 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.

(Inherited from 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.

(Inherited from 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.

(Inherited from DependencyObject)
Equals(Object)

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

(Inherited from DependencyObject)
GetHashCode()

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

(Inherited from 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.

(Inherited from DependencyObject)
GetType()

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

(Inherited from 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.

(Inherited from 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.

(Inherited from DependencyObject)
MemberwiseClone()

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

(Inherited from 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.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty)

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

(Inherited from 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 deren Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

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

(Inherited from 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.

(Inherited from 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.

(Inherited from DependencyObject)
ToString()

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

(Inherited from Object)
VerifyAccess()

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

(Inherited from DispatcherObject)

Explicit Interface Implementations

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, dass die Initialisierung beginnt.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

Signalisiert dem Objekt, dass die Initialisierung abgeschlossen ist.Signals the object that initialization is complete.

Applies to

See also