EventTrigger Classe

Définition

Représente un déclencheur qui applique un ensemble d’actions en réponse à un événement.

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
Héritage
Attributs
Implémente

Exemples

Cet exemple montre comment utiliser des déclencheurs d’événements dans un style pour animer les MouseEnter MouseLeave événements et d’un FrameworkElement . Dans cet exemple, Style a la TargetType valeur Rectangle . Par conséquent, il n’est pas nécessaire de qualifier les MouseEnter MouseLeave noms d’événements et avec le nom de la classe.

<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

Trigger les objets ont Setters les EnterActions Propriétés, et ExitActions qui appliquent des modifications ou des actions en fonction de l’état de certaines propriétés, tandis que les EventTrigger objets démarrent un ensemble de Actions lorsqu’un événement routé spécifié se produit. Par exemple, vous pouvez utiliser un EventTrigger pour démarrer un ensemble d’animations lorsque le pointeur de la souris se trouve sur un certain contrôle de l’interface utilisateur. Contrairement Trigger à, n' EventTrigger 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.

Notez que lorsque vous utilisez un EventTrigger , vous devez choisir des événements qui n’interfèrent pas avec le comportement inhérent de votre contrôle. Des contrôles tels que Button ou TextBox 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. Par exemple, si vous appliquez un style à un bouton et tentez de définir l' MouseDown événement en tant que RoutedEvent d’un EventTrigger , le EventTrigger n’est jamais appliqué, car l’événement est d’abord géré par le bouton. Au lieu de cela, vous pouvez utiliser l' PreviewMouseDown événement ou un événement différent.

Lors de l’utilisation de la liaison de données, si vous utilisez l' TargetUpdated événement, vous devez définir la NotifyOnTargetUpdated valeur de votre Binding objet sur true pour l’événement à déclencher.

L’ajout d’un TriggerAction enfant à un EventTrigger objet l’ajoute implicitement au TriggerActionCollection pour l' EventTrigger objet.

Constructeurs

EventTrigger()

Initialise une nouvelle instance de la classe EventTrigger.

EventTrigger(RoutedEvent)

Initialise une nouvelle instance de la classe EventTrigger avec l'événement spécifié.

Propriétés

Actions

Obtient la collection d’actions à appliquer quand l’événement se produit.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.

(Hérité de DispatcherObject)
EnterActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet de déclencheur devient actif. Cette propriété ne s’applique pas à la classe EventTrigger.

(Hérité de TriggerBase)
ExitActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet déclencheur devient inactif. Cette propriété ne s’applique pas à la classe EventTrigger.

(Hérité de TriggerBase)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).

(Hérité de DependencyObject)
RoutedEvent

Obtient ou définit le RoutedEvent qui activera ce déclencheur.

SourceName

Obtient ou définit le nom de l’objet avec l’événement qui active ce déclencheur. Son utilisation est réservée aux déclencheurs d’événement ou de modèle.

Méthodes

AddChild(Object)

Ajoute l'objet spécifié à la collection Actions du déclencheur d'événements actuel.

AddText(String)

Cette méthode n'est pas prise en charge et résulte en une exception.

CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey.

(Hérité de DependencyObject)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée. 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.

(Hérité de DependencyObject)
Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.

(Hérité de DependencyObject)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.

(Hérité de DependencyObject)
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.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
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. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.

(Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.

(Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.

(Hérité de DependencyObject)
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.

(Hérité de DependencyObject)
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.

(Hérité de DependencyObject)
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.

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.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.

(Hérité de DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)

Ajoute un objet enfant.

IAddChild.AddText(String)

Ajoute le contenu textuel d’un nœud à l’objet.

S’applique à

Voir aussi