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 d’un MouseLeaveFrameworkElement. Dans cet exemple, la StyleTargetType valeur est définie Rectanglesur . Par conséquent, il n’est pas nécessaire de qualifier les MouseEnter noms d’événements avec MouseLeave le nom de 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 les propriétés 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 lorsqu’un Actions événement routé spécifié se produit. Par exemple, vous pouvez utiliser un EventTrigger jeu d’animations pour démarrer un ensemble d’animations lorsque le pointeur de la souris se trouve sur un contrôle d’interface utilisateur (UI). Contrairement Triggerà , EventTrigger n’a pas de concept d’arrêt d’état, l’action ne sera donc 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 clavier. Par exemple, si vous mettez en forme un bouton et que vous essayez de définir l’événement MouseDown comme étant celui RoutedEvent d’un EventTrigger, l’événement 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 laquelle l’événement doit être déclenché.
L’ajout d’un TriggerAction enfant à un EventTrigger objet l’ajoute implicitement à l’objet TriggerActionCollectionEventTrigger .
Constructeurs
| Nom | Description |
|---|---|
| EventTrigger() |
Initialise une nouvelle instance de la classe EventTrigger. |
| EventTrigger(RoutedEvent) |
Initialise une nouvelle instance de la EventTrigger classe avec l’événement spécifié. |
Propriétés
| Nom | Description |
|---|---|
| Actions |
Obtient la collection d’actions à appliquer lorsque l’événement se produit. |
| DependencyObjectType |
Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject) |
| Dispatcher |
Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject) |
| EnterActions |
Obtient une collection d’objets TriggerAction à appliquer lorsque l’objet déclencheur devient actif. Cette propriété ne s’applique pas à la EventTrigger classe. (Hérité de TriggerBase) |
| ExitActions |
Obtient une collection d’objets TriggerAction à appliquer lorsque l’objet déclencheur devient inactif. Cette propriété ne s’applique pas à la EventTrigger classe. (Hérité de TriggerBase) |
| IsSealed |
Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject) |
| RoutedEvent |
Obtient ou définit l’activation RoutedEvent de ce déclencheur. |
| SourceName |
Obtient ou définit le nom de l’objet avec l’événement qui active ce déclencheur. Cela est utilisé uniquement par les déclencheurs d’élément ou les déclencheurs de modèle. |
Méthodes
| Nom | Description |
|---|---|
| AddChild(Object) |
Ajoute l’objet spécifié à la Actions collection du déclencheur d’événement actuel. |
| AddText(String) |
Cette méthode n’est pas prise en charge et entraîne une exception. |
| CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 un DependencyPropertyKey. (Hérité de DependencyObject) |
| CoerceValue(DependencyProperty) |
Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject) |
| Equals(Object) |
Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (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 la 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) |
Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Appelé chaque fois que la valeur effective d’une propriété de dépendance sur celle-ci 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, le cas échéant. (Hérité de DependencyObject) |
| SetCurrentValue(DependencyProperty, Object) |
Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (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 si les processus de sérialisation doivent sérialiser la valeur effective de la Actions propriété sur les 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() |
Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAddChild.AddChild(Object) |
Ajoute un objet enfant. |
| IAddChild.AddText(String) |
Ajoute le contenu texte d’un nœud à l’objet. |