EventTrigger Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Reprezentuje wyzwalacz, który stosuje zestaw akcji w odpowiedzi na zdarzenie.

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

Object

DispatcherObject

DependencyObject

TriggerBase

EventTrigger

Atrybuty

ContentPropertyAttribute

Implementuje

IAddChild

Przykłady

W tym przykładzie pokazano, jak używać wyzwalaczy zdarzeń w stylu do animowania zdarzeń MouseEnter i MouseLeave elementu FrameworkElement. W tym przykładzie parametr Style ma ustawioną wartość RectangleTargetType . W związku z tym nie ma potrzeby kwalifikowania MouseEnter nazw zdarzeń i MouseLeave z nazwą klasy.

<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ą Setterswłaściwości , EnterActionsi ExitActions , które stosują zmiany lub akcje na podstawie stanu niektórych właściwości, podczas gdy EventTrigger obiekty rozpoczynają zestaw Actions po wystąpieniu określonego zdarzenia kierowanego. Na przykład można użyć elementu EventTrigger , aby uruchomić zestaw animacji, gdy wskaźnik myszy jest nad określoną kontrolką interfejsu użytkownika. W przeciwieństwie do Triggerelementu EventTrigger nie ma pojęcia zakończenia stanu, więc akcja nie zostanie cofniętą, gdy warunek, który wywołał zdarzenie, nie będzie już spełniony.

Należy pamiętać, że w przypadku korzystania z EventTriggerelementu należy wybrać zdarzenia, które nie zakłócają właściwego zachowania kontrolki. Kontrolki, takie jak Button lub TextBox wykonywanie określonych akcji na zdarzeniach wejściowych użytkownika, takich jak kliknięcia myszy i zdarzenia klawiatury. Jeśli na przykład stylizujesz przycisk i spróbujesz ustawić MouseDown zdarzenie jako RoutedEventEventTriggerelement , nigdy nie zostanie zastosowane, EventTrigger ponieważ zdarzenie najpierw zostanie obsłużone przez przycisk. Zamiast tego możesz użyć PreviewMouseDown zdarzenia lub innego zdarzenia.

Jeśli używasz powiązania danych, jeśli używasz TargetUpdated zdarzenia, musisz ustawić NotifyOnTargetUpdated wartość Binding obiektu na wartość , aby true zdarzenie zostało zgłoszone.

Dodanie elementu podrzędnego TriggerActionEventTrigger do obiektu niejawnie powoduje dodanie go do TriggerActionCollection obiektu dla EventTrigger obiektu .

Konstruktory

EventTrigger()	Inicjuje nowe wystąpienie klasy EventTrigger.
EventTrigger(RoutedEvent)	Inicjuje EventTrigger nowe wystąpienie klasy z określonym zdarzeniem.

Właściwości

Actions	Pobiera kolekcję akcji, które mają być stosowane w przypadku wystąpienia zdarzenia.
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
EnterActions	Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się aktywny. Ta właściwość nie ma zastosowania do EventTrigger klasy . (Odziedziczone po TriggerBase)
ExitActions	Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się nieaktywny. Ta właściwość nie ma zastosowania do EventTrigger klasy . (Odziedziczone po TriggerBase)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
RoutedEvent	Pobiera lub ustawia RoutedEvent wyzwalacz, który aktywuje ten wyzwalacz.
SourceName	Pobiera lub ustawia nazwę obiektu ze zdarzeniem, które aktywuje ten wyzwalacz. Jest to używane tylko przez wyzwalacze elementów lub wyzwalacze szablonu.

Metody

AddChild(Object)	Dodaje określony obiekt do Actions kolekcji bieżącego wyzwalacza zdarzenia.
AddText(String)	Ta metoda nie jest obsługiwana i powoduje wyjątek.
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. 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, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która została zmieniona, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeActions()	Zwraca, czy procesy serializacji powinny serializować efektywną wartość Actions właściwości w wystąpieniach tej klasy.
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)	Dodaje obiekt podrzędny.
IAddChild.AddText(String)	Dodaje do obiektu zawartość tekstową węzła.

Zobacz też

• EventSetter