Langage

EventTrigger Classe

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

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é. Voir les remarques.

public ref class EventTrigger sealed : TriggerBase
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class EventTrigger final : TriggerBase
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class EventTrigger : TriggerBase
Public NotInheritable Class EventTrigger
Inherits TriggerBase
Héritage
Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger
Attributs
ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 storyboarded. Ce code XAML montre les éléments de conteneur EventTrigger et BeginStoryboard dans une relation appropriée avec chacun à 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 initialement utilisée 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 :

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é que c’est à la fois la valeur par défaut et le 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">. « Loaded » non qualifié ou toute autre valeur, lève une exception d’analyse. Pour plus d’informations, consultez Déclencheurs.

Constructeurs

Nom Description
EventTrigger()

Initialise une nouvelle instance de la classe EventTrigger .

Propriétés

Nom Description
Actions

Obtient la collection d’objets BeginStoryboard que cet EventTrigger gère.
Dispatcher

Retourne null toujours dans une application du Kit de développement logiciel (SDK) d’application Windows. Utilisez DispatcherQueue à la place.

(Hérité de DependencyObject)
DispatcherQueue

Obtient le DispatcherQueue résultat auquel cet objet est associé. Représente DispatcherQueue une installation qui peut accéder au DependencyObject thread d’interface utilisateur même si le code est initié par un thread non-interface utilisateur.

(Hérité de DependencyObject)
RoutedEvent

Obtient ou définit le nom de l’événement qui lance le déclencheur. Pas couramment défini, voir Remarques.

Méthodes

Nom Description
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’applique 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 à une dependencyProperty spécifique sur cette 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 qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback.

(Hérité de DependencyObject)

S’applique à

Voir aussi