EventTrigger Classe
Définition
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
- Attributs
- Implémente
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. |