EventTrigger Klasse

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 Sie Ereignistrigger in einem Stil verwenden, um die MouseEnter Ereignisse und MouseLeave eines FrameworkElementzu animieren. In diesem Beispiel ist die Style TargetType auf Rectanglefestgelegt. Daher ist es nicht erforderlich, die Ereignisnamen und MouseLeave den MouseEnter 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 SettersEigenschaften , EnterActions, und ExitActions , die Änderungen oder Aktionen basierend auf dem Zustand bestimmter Eigenschaften anwenden, während EventTrigger Objekte einen Satz von Actions starten, wenn ein angegebenes Routingereignis auftritt. Sie können beispielsweise einen EventTrigger verwenden, um eine Reihe von Animationen zu starten, wenn sich der Mauszeiger über einem bestimmten Steuerelement der Benutzeroberfläche befindet. Im Gegensatz zu Trigger, EventTrigger hat kein Konzept der Beendigung des Zustands, sodass die Aktion nicht rückgängig wird, sobald die Bedingung, die das Ereignis ausgelöst hat, nicht mehr wahr ist.

Beachten Sie, dass Sie bei Verwendung eines ereignisses EventTriggerauswählen müssen, die das inhärente Verhalten Ihres Steuerelements nicht beeinträchtigen. Steuerelemente wie Button oder TextBox führen bestimmte Aktionen für Benutzereingabeereignisse wie Mausklicks und Tastaturereignisse aus. Wenn Sie beispielsweise eine Schaltfläche formatieren und versuchen, das MouseDown Ereignis auf ein RoutedEvent EventTriggerfestzulegen, wird nie EventTrigger 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 den TargetUpdated NotifyOnTargetUpdated Wert Ihres Binding Objekts auf festlegen, damit true das Ereignis ausgelöst wird.

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

Konstruktoren

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

Eigenschaften

Actions	Ruft die Auflistung der Aktionen ab, die ausgeführt werden sollen, wenn das Ereignis auftritt.
DependencyObjectType	Ruft die ab, die DependencyObjectType den CLR-Typ dieser instance 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)
RoutedEvent	Ruft dieses RoutedEvent ab oder legt es fest, das diesen Trigger aktiviert.
SourceName	Ruft den Namen des Objekts mit dem Ereignis ab, das diesen Trigger aktiviert, oder legt ihn fest. Wird nur von Elementtriggern oder Vorlagentriggern verwendet.

Methoden

AddChild(Object)	Fügt das angegebene Objekt der Actions-Auflistung des aktuellen Ereignistriggers hinzu.
AddText(String)	Diese Methode wird nicht unterstützt und löst eine Ausnahme aus.
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)
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)
ShouldSerializeActions()	Gibt zurück, ob Serialisierungsprozesse den tatsächlichen Wert der Actions-Eigenschaft bei Instanzen dieser Klasse serialisieren sollen.
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.

Gilt für: