EventTrigger Klasa

Definicja

Reprezentuje wyzwalacz, który stosuje zestaw akcji w odpowiedzi na zdarzenie.Represents a trigger that applies a set of actions in response to an event.

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
Dziedziczenie
Atrybuty
Implementuje

Przykłady

Ten przykład pokazuje, jak używać wyzwalaczy zdarzeń w stylu do animowania MouseEnter zdarzeń i MouseLeave FrameworkElement .This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. W tym przykładzie Style ma TargetType ustawioną wartość Rectangle .In this example, the Style has the TargetType set to Rectangle. W związku z tym nie ma potrzeby kwalifikowania MouseEnter MouseLeave nazw zdarzeń i nazwy klasy.Therefore, there is no need to qualify the MouseEnter and MouseLeave event names with the class name.

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

Uwagi

Trigger obiekty mają Setters właściwości, EnterActions i, ExitActions które stosują zmiany lub akcje na podstawie stanu pewnych właściwości, podczas gdy EventTrigger obiekty uruchamiają zestaw Actions po wystąpieniu określonego zdarzenia kierowanego.Trigger objects have the Setters, EnterActions, and ExitActions properties that apply changes or actions based on the state of certain properties, while EventTrigger objects start a set of Actions when a specified routed event occurs. Na przykład możesz chcieć użyć EventTrigger do uruchomienia zestawu animacji, gdy wskaźnik myszy znajduje się nad określonym formantem interfejsu użytkownika.For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain user interface (UI) control. W przeciwieństwie do Trigger , EventTrigger nie ma koncepcji zakończenia stanu, więc akcja nie zostanie cofnięta, gdy stan, który spowodował zdarzenie, nie będzie już prawdziwy.Unlike Trigger, EventTrigger has no concept of termination of state, so the action will not be undone once the condition that raised the event is no longer true.

Należy pamiętać, że w przypadku korzystania z programu należy EventTrigger wybrać zdarzenia, które nie zakłócają działania związanego z kontrolką.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. Kontrolki, takie jak Button lub TextBox wykonywanie określonych akcji dotyczących zdarzeń wejściowych użytkownika, takich jak kliknięcia myszą i zdarzenia klawiatury.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. Na przykład jeśli ustawisz styl przycisku i spróbujesz ustawić MouseDown zdarzenie jako RoutedEvent z EventTrigger , EventTrigger nigdy nie zostanie zastosowane, ponieważ zdarzenie jest najpierw obsługiwane przez przycisk.For example, if you are styling a button and try to set the MouseDown event as the RoutedEvent of an EventTrigger, the EventTrigger never gets applied because the event first gets handled by the button. Zamiast tego można użyć PreviewMouseDown zdarzenia lub innego zdarzenia.Instead, you can use the PreviewMouseDown event or a different event.

W przypadku korzystania z powiązania danych, jeśli używasz TargetUpdated zdarzenia, musisz ustawić NotifyOnTargetUpdated wartość Binding obiektu na true dla zdarzenia, które ma zostać zgłoszone.When using data binding, if you are using the TargetUpdated event, you must set the NotifyOnTargetUpdated value of your Binding object to true for the event to be raised.

Dodanie TriggerAction elementu podrzędnego do EventTrigger obiektu niejawnie dodaje go do TriggerActionCollection EventTrigger obiektu.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Konstruktory

EventTrigger()

Inicjuje nowe wystąpienie klasy EventTrigger.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent)

Inicjuje nowe wystąpienie EventTrigger klasy z określonym zdarzeniem.Initializes a new instance of the EventTrigger class with the specified event.

Właściwości

Actions

Pobiera kolekcję akcji do zastosowania, gdy wystąpi zdarzenie.Gets the collection of actions to apply when the event occurs.

DependencyObjectType

Pobiera DependencyObjectType , który zawija typ CLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
EnterActions

Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza stanie się aktywny.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Ta właściwość nie ma zastosowania do EventTrigger klasy.This property does not apply to the EventTrigger class.

(Odziedziczone po TriggerBase)
ExitActions

Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się nieaktywny.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Ta właściwość nie ma zastosowania do EventTrigger klasy.This property does not apply to the EventTrigger class.

(Odziedziczone po TriggerBase)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
RoutedEvent

Pobiera lub ustawia RoutedEvent , który będzie uaktywnia ten wyzwalacz.Gets or sets the RoutedEvent that will activate this trigger.

SourceName

Pobiera lub ustawia nazwę obiektu ze zdarzeniem, które aktywuje ten wyzwalacz.Gets or sets the name of the object with the event that activates this trigger. Jest to używane tylko przez wyzwalacze elementu lub wyzwalacze szablonu.This is only used by element triggers or template triggers.

Metody

AddChild(Object)

Dodaje określony obiekt do Actions kolekcji bieżącego wyzwalacza zdarzeń.Adds the specified object to the Actions collection of the current event trigger.

AddText(String)

Ta metoda nie jest obsługiwana i powoduje wyjątek.This method is not supported and results in an exception.

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeActions()

Zwraca czy procesy serializacji powinny serializować wartość efektywną Actions właściwości w wystąpieniach tej klasy.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)

Dodaje obiekt podrzędny.Adds a child object.

IAddChild.AddText(String)

Dodaje zawartość tekstową węzła do obiektu.Adds the text content of a node to the object.

Dotyczy

Zobacz też