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 (storyboards d’animation) en réponse à un événement. Ce n’est pas couramment utilisé. Consultez la section Notes.
public ref class EventTrigger sealed : TriggerBase
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
class EventTrigger final : TriggerBase
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
public sealed class EventTrigger : TriggerBase
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase
Public NotInheritable Class EventTrigger
Inherits TriggerBase
<EventTrigger>
oneOrMoreBeginStoryboards
</EventTrigger>
- Héritage
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Exemples
Cet exemple XAML montre la structure de base pour l’utilisation de FrameworkElement.Triggers avec son comportement de déclencheur FrameworkElement.Loaded par défaut pour exécuter une animation de table de montage séquentiel. Ce code XAML montre les éléments conteneur EventTrigger et BeginStoryboard dans une relation appropriée avec chacun d’eux à l’aide de leur syntaxe de propriété de contenu XAML et des balises d’éléments de propriété inutiles omises.
<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
<Canvas.Triggers>
<EventTrigger>
<BeginStoryboard>
<Storyboard x:Name="ColorStoryboard">
<!-- Animate the background of the canvas to green over 4 seconds. -->
<ColorAnimation Storyboard.TargetName="animatedcanvas"
Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
To="Green" Duration="0:0:4"/>
</Storyboard>
</BeginStoryboard>
</EventTrigger>
</Canvas.Triggers>
</Canvas>
Remarques
Les déclencheurs, EventTrigger, Actions et BeginStoryboard ne sont pas couramment utilisés. Ces API existent principalement pour la compatibilité dans XAML utilisé à l’origine pour Microsoft Silverlight. Pour la plupart des scénarios où des déclencheurs d’événements ont été utilisés précédemment, effectuez l’une des opérations suivantes :
- Utilisez les animations intégrées de la bibliothèque d’animations. Consultez Démarrage rapide : Animation de votre interface utilisateur à l’aide de la bibliothèque d’animations.
- Pour les événements dans les modèles de contrôle, utilisez les états visuels et VisualStateManager. Consultez Animations storyboard pour les états visuels ou Démarrage rapide : Modèles de contrôle.
- Pour les animations d’interface utilisateur spécifiques à l’application, définissez un gestionnaire Chargé sur la page. Ce gestionnaire peut référencer un Storyboard défini dans les ressources au niveau de la page et appeler la méthode Begin sur ce Storyboard. Consultez Animations de table de montage séquentiel.
Si vous choisissez d’utiliser des déclencheurs, dans Windows Runtime XAML, le comportement par défaut pour les déclencheurs d’événements et le seul événement qui peut être utilisé pour appeler un EventTrigger est FrameworkElement.Loaded. Étant donné qu’il s’agit à la fois du comportement par défaut et du seul comportement activé, ne définissez pas l’attribut RoutedEvent . Utilisez simplement le CODE XAML <EventTrigger>
. Si vous définissez RoutedEvent explicitement (non recommandé), le seul XAML qui fonctionne est <EventTrigger RoutedEvent="FrameworkElement.Loaded">
. Une valeur « Loaded » non qualifiée, ou toute autre valeur, lève une exception d’analyse. Pour plus d’informations, consultez Déclencheurs.
Constructeurs
EventTrigger() |
Initialise une nouvelle instance de la classe EventTrigger. |
Propriétés
Actions |
Obtient la collection d’objets BeginStoryboard que cet EventTrigger gère. |
Dispatcher |
Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject) |
RoutedEvent |
Obtient ou définit le nom de l’événement qui lance le déclencheur. Ce n’est pas couramment défini, consultez Remarques. |
Méthodes
ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject) |
SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |