EventTrigger EventTrigger EventTrigger EventTrigger Class

Définition

Représente un déclencheur qui applique un ensemble d’actions en réponse à un événement.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
Héritage
Attributs
Implémente

Exemples

Cet exemple montre comment utiliser des déclencheurs d’événements dans un style pour animer MouseLeave les MouseEnter événements et FrameworkElementd’un.This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. Dans cet exemple, Style a la TargetType valeur Rectangle.In this example, the Style has the TargetType set to Rectangle. Par conséquent, il n’est pas nécessaire de MouseEnter qualifier MouseLeave les noms d’événements et avec le nom de la 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>

Remarques

Triggerles objets ont Settersles EnterActionspropriétés, ExitActions et qui appliquent des modifications ou des actions en fonction de l’état de EventTrigger certaines propriétés, tandis Actions que les objets démarrent un ensemble de lorsqu’un événement routé spécifié se produit.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. Par exemple, vous souhaiterez peut-être EventTrigger utiliser un pour démarrer un ensemble d’animations lorsque le pointeur de la souris interface utilisateur (UI)user interface (UI) se trouve sur un certain contrôle.For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain interface utilisateur (UI)user interface (UI) control. Contrairement Triggerà EventTrigger , n’a aucun concept d’arrêt de l’État. l’action n’est donc pas annulée une fois que la condition qui a déclenché l’événement n’est plus remplie.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.

Notez que lorsque vous utilisez EventTriggerun, vous devez choisir des événements qui n’interfèrent pas avec le comportement inhérent de votre contrôle.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. Des contrôles tels Button que TextBox ou exécutent des actions spécifiques sur les événements d’entrée utilisateur, tels que les clics de souris et les événements de clavier.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. Par exemple, si vous appliquez un style à un bouton et tentez de MouseDown définir l’événement RoutedEvent en tant EventTriggerque d' EventTrigger un, le n’est jamais appliqué, car l’événement est d’abord géré par le bouton.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. Au lieu de cela, vous PreviewMouseDown pouvez utiliser l’événement ou un événement différent.Instead, you can use the PreviewMouseDown event or a different event.

Lors de l’utilisation de la liaison de données, TargetUpdated si vous utilisez l’événement, NotifyOnTargetUpdated vous devez définir Binding la valeur true de votre objet sur pour l’événement à déclencher.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’ajout TriggerAction d’un enfant EventTrigger à un objet l' TriggerActionCollection ajoute implicitement au pour EventTrigger l’objet.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Constructeurs

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

Initialise une nouvelle instance de la classe EventTrigger.Initializes a new instance of the EventTrigger class.

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

Initialise une nouvelle instance de la classe EventTrigger avec l'événement spécifié.Initializes a new instance of the EventTrigger class with the specified event.

Propriétés

Actions Actions Actions Actions

Obtient la collection d’actions à appliquer quand l’événement se produit.Gets the collection of actions to apply when the event occurs.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet de déclencheur devient actif.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Cette propriété ne s’applique pas à la classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet déclencheur devient inactif.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Cette propriété ne s’applique pas à la classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
RoutedEvent RoutedEvent RoutedEvent RoutedEvent

Obtient ou définit le RoutedEvent qui activera ce déclencheur.Gets or sets the RoutedEvent that will activate this trigger.

SourceName SourceName SourceName SourceName

Obtient ou définit le nom de l’objet avec l’événement qui active ce déclencheur.Gets or sets the name of the object with the event that activates this trigger. Son utilisation est réservée aux déclencheurs d’événement ou de modèle.This is only used by element triggers or template triggers.

Méthodes

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

Ajoute l'objet spécifié à la collection Actions du déclencheur d'événements actuel.Adds the specified object to the Actions collection of the current event trigger.

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

Cette méthode n'est pas prise en charge et résulte en une exception.This method is not supported and results in an exception.

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

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

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

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

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

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

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

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.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)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

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

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

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

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un 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)

Réévalue la valeur effective pour la propriété de dépendance spécifiéeRe-evaluates the effective value for the specified dependency property

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a été modifiée est signalée dans les données d'événement.The specific dependency property that changed is reported in the event data.

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

Retourne la valeur locale d’une propriété de dépendance, si elle existe.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)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.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)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.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)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.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()

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur effective de la propriété Actions au niveau des instances de cette 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)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

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

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implémentations d’interfaces explicites

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

Ajoute un objet enfant.Adds a child object.

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

Ajoute le contenu textuel d’un nœud à l’objet.Adds the text content of a node to the object.

S’applique à

Voir aussi