EventTrigger Klasa

Definicja

Przestrzeń nazw:: System.Windows

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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 MouseEnter zdarzeń i MouseLeave elementu FrameworkElement. W tym przykładzie parametr Style ma ustawioną wartość TargetType Rectangle . 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 trasy. Na przykład możesz 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ą po wystąpieniu warunku, który spowodował zdarzenie, nie będzie już spełniony.

Należy pamiętać, że w przypadku korzystania z elementu EventTriggernależy wybrać zdarzenia, które nie zakłócają właściwego zachowania kontrolki. Kontrolki, takie jak Button lub TextBox wykonujące określone akcje na zdarzeniach wprowadzania przez użytkownika, takich jak kliknięcia myszy i zdarzenia klawiatury. Jeśli na przykład stylizujesz przycisk i spróbujesz ustawić MouseDown zdarzenie jako RoutedEvent EventTriggerelement , nigdy nie zostanie zastosowane, EventTrigger ponieważ zdarzenie zostanie najpierw 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 TriggerAction EventTrigger do obiektu niejawnie powoduje dodanie go do TriggerActionCollection obiektu dla EventTrigger obiektu .

Konstruktory

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

Właściwości

Nazwa	Opis
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 elementDispatcher, z 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 za pomocą zdarzenia, które aktywuje ten wyzwalacz. Jest to używane tylko przez wyzwalacze elementów lub wyzwalacze szablonu.

Metody

Nazwa	Opis
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 DependencyPropertyKeyelement . (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 elementu DependencyObject. (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 na tym DependencyObjectobiekcie . (Odziedziczone po DependencyObject)
GetType()	Pobiera Type 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 obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (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 uległa zmianie, 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 ź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ść 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

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

Dotyczy

Zobacz też

EventSetter

Opinia

Czy ta strona była pomocna?