EventTrigger Klasse

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Stellt einen Trigger dar, der eine Reihe von Aktionen als Reaktion auf ein Ereignis anwendet.

public ref class EventTrigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Actions")]
public class EventTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Actions")>]
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild

Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild

Vererbung

Object

DispatcherObject

DependencyObject

TriggerBase

EventTrigger

Attribute

ContentPropertyAttribute

Implementiert

IAddChild

Beispiele

In diesem Beispiel wird gezeigt, wie Ereignistrigger in einer Formatvorlage verwendet werden, um die MouseEnter Ereignisse MouseLeave eines Objekts FrameworkElementzu animieren. In diesem Beispiel ist der StyleTargetType Satz auf Rectangle. Daher ist es nicht erforderlich, die Namen und MouseEnterMouseLeave Ereignisse mit dem Klassennamen zu qualifizieren.

<Style TargetType="Rectangle">
  <Setter Property="Width" Value="50" />
  <Setter Property="Height" Value="50" />
  <Setter Property="Margin" Value="20" />
  <Setter Property="HorizontalAlignment" Value="Left" />
  <Style.Triggers>
    <EventTrigger RoutedEvent="MouseEnter">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation To="300" Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
    <EventTrigger RoutedEvent="MouseLeave">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
  </Style.Triggers>
</Style>

Hinweise

Trigger Objekte verfügen über die Setters, EnterActionsund ExitActions Eigenschaften, die Änderungen oder Aktionen basierend auf dem Status bestimmter Eigenschaften anwenden, während EventTrigger Objekte eine Reihe von Actions Zeitpunkten starten, wenn ein angegebenes Routingereignis eintritt. Sie können z. B. einen EventTrigger Satz von Animationen starten, wenn sich der Mauszeiger über einem bestimmten Benutzeroberflächensteuerelement befindet. EventTrigger Im Gegensatz dazu Triggergibt es kein Konzept zum Beenden des Zustands, sodass die Aktion nicht rückgängig gemacht wird, sobald die Bedingung, die das Ereignis ausgelöst hat, nicht mehr wahr ist.

Beachten Sie, dass Sie bei der Verwendung eines EventTriggerSteuerelements Ereignisse auswählen müssen, die das inhärente Verhalten Ihres Steuerelements nicht beeinträchtigen. Steuerelemente, z ButtonTextBox . B. bestimmte Aktionen für Benutzereingabeereignisse wie Mausklicks und Tastaturereignisse. Wenn Sie beispielsweise eine Schaltfläche formatieren und versuchen, das MouseDown Ereignis als RoutedEvent ein EventTriggerEreignis festzulegen, wird das EventTrigger Ereignis nie angewendet, da das Ereignis zuerst von der Schaltfläche behandelt wird. Stattdessen können Sie das PreviewMouseDown Ereignis oder ein anderes Ereignis verwenden.

Wenn Sie die Datenbindung verwenden, müssen Sie bei Verwendung des TargetUpdated Ereignisses den NotifyOnTargetUpdated Wert des Binding Objekts true so festlegen, dass das Ereignis ausgelöst wird.

Das Hinzufügen eines TriggerAction untergeordneten Elements zu einem EventTrigger Objekt fügt es implizit dem TriggerActionCollection Objekt für das EventTrigger Objekt hinzu.

Konstruktoren

Name	Beschreibung
EventTrigger()	Initialisiert eine neue Instanz der EventTrigger-Klasse.
EventTrigger(RoutedEvent)	Initialisiert eine neue Instanz der EventTrigger Klasse mit dem angegebenen Ereignis.

Eigenschaften

Name	Beschreibung
Actions	Ruft die Auflistung von Aktionen ab, die angewendet werden sollen, wenn das Ereignis auftritt.
DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
EnterActions	Ruft eine Auflistung von TriggerAction Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt aktiv 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 inaktiv wird. Diese Eigenschaft gilt nicht für die EventTrigger Klasse. (Geerbt von TriggerBase)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)
RoutedEvent	Dient zum Abrufen oder Festlegen des Triggers, der RoutedEvent diesen Auslöser aktiviert.
SourceName	Dient zum Abrufen oder Festlegen des Namens des Objekts mit dem Ereignis, das diesen Trigger aktiviert. Dies wird nur von Elementtriggern oder Vorlagentriggern verwendet.

Methoden

Name	Beschreibung
AddChild(Object)	Fügt das angegebene Objekt der Actions Auflistung des aktuellen Ereignistriggers hinzu.
AddText(String)	Diese Methode wird nicht unterstützt und führt zu einer Ausnahme.
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (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 der aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (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 wird. (Geerbt von DependencyObject)
ShouldSerializeActions()	Gibt zurück, ob Serialisierungsprozesse den effektiven Wert der Actions Eigenschaft auf Instanzen dieser Klasse serialisieren sollen.
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte 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 Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IAddChild.AddChild(Object)	Fügt ein untergeordnetes Objekt hinzu.
IAddChild.AddText(String)	Fügt dem Objekt den Textinhalt eines Knotens hinzu.

Weitere Informationen

• EventSetter