EventTrigger EventTrigger EventTrigger EventTrigger Class

Definizione

Rappresenta un trigger che applica un set di azioni in risposta a un evento.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
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild
Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild
Ereditarietà
Attributi
Implementazioni

Esempi

Questo esempio illustra come usare i trigger di evento in uno stile per animare MouseEnter gli MouseLeave eventi e di FrameworkElementun oggetto.This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. In questo esempio l'oggetto Style TargetType è impostato su Rectangle.In this example, the Style has the TargetType set to Rectangle. Pertanto, non è necessario qualificare i MouseEnter nomi di evento e MouseLeave con il nome della classe.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>

Commenti

Triggergli oggetti dispongono Settersdelle EnterActionsproprietà, ExitActions e che applicano modifiche o azioni in base allo stato di determinate proprietà, EventTrigger mentre gli oggetti avviano Actions un set di quando si verifica un evento indirizzato specificato.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. Ad esempio, è possibile usare un oggetto EventTrigger per avviare un set di animazioni quando il puntatore del mouse è posizionato su un determinato interfaccia utenteuser interface (UI) controllo.For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain interfaccia utenteuser interface (UI) control. Diversamente Triggerda, EventTrigger non ha alcun concetto di terminazione dello stato, pertanto l'azione non verrà annullata quando la condizione che ha generato l'evento non è più vera.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.

Si noti che quando si EventTriggerusa un, è necessario scegliere gli eventi che non interferiscono con il comportamento intrinseco del controllo.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. Controlli quali Button o TextBox eseguono azioni specifiche sugli eventi di input dell'utente, ad esempio i clic del mouse e gli eventi della tastiera.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. Se, ad esempio, MouseDown si esegue lo stile RoutedEvent di un pulsante e si tenta di impostare l'evento come di EventTrigger un oggetto EventTrigger, non viene mai applicato perché l'evento viene prima gestito dal pulsante.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. In alternativa, è possibile usare PreviewMouseDown l'evento o un evento diverso.Instead, you can use the PreviewMouseDown event or a different event.

Quando si utilizza Data Binding, se si utilizza l' TargetUpdated evento, è necessario impostare il NotifyOnTargetUpdated valore dell' Binding oggetto su true per l'evento da generare.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.

L'aggiunta TriggerAction di un elemento EventTrigger figlio a un oggetto lo aggiunge in TriggerActionCollection modo implicito a per l' EventTrigger oggetto.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Costruttori

EventTrigger() EventTrigger() EventTrigger() EventTrigger()

Inizializza una nuova istanza della classe EventTrigger.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent)

Inizializza una nuova istanza della classe EventTrigger con l'evento specificato.Initializes a new instance of the EventTrigger class with the specified event.

Proprietà

Actions Actions Actions Actions

Ottiene la raccolta di azioni da applicare quando si verifica l'evento.Gets the collection of actions to apply when the event occurs.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa attivo.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Questa proprietà non si applica alla classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa inattivo.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Questa proprietà non si applica alla classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
RoutedEvent RoutedEvent RoutedEvent RoutedEvent

Ottiene o imposta l'oggetto RoutedEvent che attiverà questo trigger.Gets or sets the RoutedEvent that will activate this trigger.

SourceName SourceName SourceName SourceName

Ottiene o imposta il nome dell'oggetto con l'evento che attiva il trigger.Gets or sets the name of the object with the event that activates this trigger. Viene usata solo dai trigger di elemento o dai trigger di modello.This is only used by element triggers or template triggers.

Metodi

AddChild(Object) AddChild(Object) AddChild(Object) AddChild(Object)

Aggiunge l'oggetto specificato all'insieme Actions del trigger dell'evento corrente.Adds the specified object to the Actions collection of the current event trigger.

AddText(String) AddText(String) AddText(String) AddText(String)

Questo metodo non è supportato e sfocia in un'eccezione.This method is not supported and results in an exception.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Ottiene un codice hash per DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La specifica proprietà di dipendenza modificata viene indicata nei dati dell'evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions()

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della proprietà Actions in istanze di questa classe.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implementazioni dell'interfaccia esplicita

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Aggiunge un oggetto figlio.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Aggiunge il contenuto di testo di un nodo all'oggetto.Adds the text content of a node to the object.

Si applica a

Vedi anche