Trigger Trigger Trigger Trigger Class

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

Das folgende Beispiel zeigt eine benannte Style zur Button Steuerelemente.The following example shows a named Style available to Button controls. Die Style definiert eine Trigger -Element, das Änderungen der Foreground -Eigenschaft einer Schaltfläche bei der IsPressed -Eigenschaft ist true.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>

Hinweise

WPFWPF definiert Eigenschaften, die Endbenutzeraktionen, z. B. entsprechen den IsMouseOver Eigenschaft, um festgelegt wird true Wenn der Benutzer den Cursor auf zeigen eine UIElement oder dem entsprechenden IsMouseOver Eigenschaft eine ContentElement.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. Der Endbenutzeraktionen in Eigenschaftswerten darstellt, zusammen mit den Trigger -Element, ermöglicht WPFWPF Stile auf die Eigenschaftswerte sofort geändert basierend auf diesen Endbenutzeraktionen alle im Markup.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 durch Trigger geändert 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 flüchtige wie z. B. Zustände die erwartet werden, um zu ändern und Zurücksetzen auf den ursprünglichen Zustand optimiert 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ängigkeitseigenschaft sein.The Property of interest must be a dependency property.

Beachten Sie, dass Sie beide angeben können, müssen die Property und Value Eigenschaften für eine Trigger für den Trigger 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 der Eigenschaften nicht festgelegt werden, wird eine Ausnahme ausgelöst.If one or both of the properties are not set, an exception is thrown.

Die Setters Eigenschaft eine Trigger Objekt kann nur bestehen Setter Objekte.The Setters property of a Trigger object can only consist of Setter objects. Hinzufügen einer Setter untergeordnetes Element eine Trigger Objekt implizit hinzugefügt der SetterBaseCollection für die Trigger Objekt.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 können Sie basierte auf den Zustand der Eigenschaften, die mehrere Änderungen zu übernehmen.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger ermöglicht Ihnen, Änderungen zu übernehmen, wenn ein Ereignis auftritt.EventTrigger allows you to apply changes when an event occurs. DataTrigger und MultiDataTrigger für datengebundene Eigenschaften sind.DataTrigger and MultiDataTrigger are for data-bound properties.

Konstruktoren

Trigger() Trigger() Trigger() Trigger()

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

Eigenschaften

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

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions 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 ExitActions ExitActions 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 IsSealed IsSealed 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 Property Property 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 Setters Setters 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 SourceName SourceName 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 Value Value 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() CheckAccess() CheckAccess() CheckAccess()

Bestimmt, ob der aufrufende Thread den Zugriff auf diese kann DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) 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) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) 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) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) 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) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() 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() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) 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) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Berechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neuRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) 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. Die spezifische Abhängigkeitseigenschaft, die sich geändert hat, wird in den Ereignisdaten angegeben.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

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

(Inherited from DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) 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) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, 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.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) 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() ToString() ToString() ToString()

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

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

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

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

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

ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit()

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

ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit()

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

Gilt für:

Siehe auch