EventTrigger Classe

Référence

Définition

Espace de noms:: System.Windows

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: Object

DispatcherObject

DependencyObject

TriggerBase
EventTrigger

Attributs: ContentPropertyAttribute

Implémente: IAddChild

Exemples

Cet exemple montre comment utiliser des déclencheurs d’événements dans un style pour animer les MouseEnter événements et MouseLeave d’un FrameworkElement. Dans cet exemple, a Style la TargetType valeur définie sur Rectangle. Par conséquent, il n’est pas nécessaire de qualifier les noms d’événements MouseEnter et MouseLeave 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 les Setterspropriétés , EnterActionset ExitActions qui appliquent des modifications ou des actions en fonction de l’état de certaines propriétés, tandis que EventTrigger les objets démarrent un ensemble de Actions quand un événement routé spécifié se produit. Par exemple, vous pouvez utiliser un pour démarrer un ensemble d’animations EventTrigger lorsque le pointeur de la souris se trouve sur un certain contrôle d’interface utilisateur. Contrairement à Trigger, EventTrigger n’ayant aucun concept de fin d’état, l’action ne sera pas annulée une fois que la condition qui a déclenché l’événement n’est plus vraie.

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. Contrôles tels que Button ou TextBox effectuer 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 stylez un bouton et que vous essayez de définir l’événement MouseDown comme étant le 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’événement PreviewMouseDown ou un autre événement.

Lorsque vous utilisez la liaison de données, si vous utilisez l’événement TargetUpdated , vous devez définir la NotifyOnTargetUpdated valeur de votre Binding objet sur true pour que l’événement soit déclenché.

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

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 à