EventTrigger Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Rappresenta un trigger che applica un set di azioni (storyboard di animazione) in risposta a un evento. Non comunemente usato. Vedere la sezione Osservazioni.

public ref class EventTrigger sealed : 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.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>
 

Ereditarietà

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Questo esempio XAML mostra la struttura di base per l'uso di FrameworkElement.Triggers con il comportamento predefinito del trigger FrameworkElement.Loaded per eseguire un'animazione con storyboard. Questo codice XAML mostra gli elementi del contenitore EventTrigger e BeginStoryboard nella relazione appropriata con ognuno usando la sintassi della proprietà del contenuto XAML e i tag degli elementi di proprietà non necessari omessi.

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

Commenti

I trigger, EventTrigger, Actions e BeginStoryboard non vengono comunemente usati. Queste API esistono principalmente per la compatibilità in XAML usato originariamente per Microsoft Silverlight. Per la maggior parte degli scenari in cui i trigger di evento sono stati usati in precedenza, eseguire una di queste operazioni:

• Usa animazioni predefinite dalla libreria di animazioni. Vedi Guida introduttiva: Animazione dell'interfaccia utente con la libreria di animazioni.
• Per gli eventi nei modelli di controllo, usare gli stati di visualizzazione e VisualStateManager. Vedi Animazioni con storyboard per gli stati di visualizzazione o Avvio rapido: Modelli di controllo.
• Per le animazioni dell'interfaccia utente specifiche dell'app, definire un gestore caricato nella pagina. Questo gestore può fare riferimento a uno Storyboard definito nelle risorse a livello di pagina e chiamare il metodo Begin in tale storyboard. Vedi Animazioni con storyboard.

Se scegli di usare Trigger, in Windows Runtime XAML, il comportamento predefinito per i trigger di evento e l'unico evento che può essere usato per richiamare un EventTrigger è FrameworkElement.Loaded. Poiché si tratta sia del comportamento predefinito che dell'unico comportamento abilitato, non impostare l'attributo RoutedEvent . È sufficiente usare il codice XAML <EventTrigger>. Se si imposta RoutedEvent in modo esplicito (non consigliato), l'unico codice XAML che funziona è <EventTrigger RoutedEvent="FrameworkElement.Loaded">. "Loaded" non qualificato o qualsiasi altro valore genera un'eccezione di analisi. Per altre info, vedi Trigger.

Costruttori

EventTrigger()

Inizializza una nuova istanza della classe EventTrigger .

Proprietà

Actions	Ottiene l'insieme di oggetti BeginStoryboard che l'oggetto EventTrigger gestisce.
Dispatcher	Ottiene coreDispatcher a cui è associato questo oggetto. CoreDispatcher rappresenta una funzionalità che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)
RoutedEvent	Ottiene o imposta il nome dell'evento che avvia il trigger. Non impostata comunemente, vedere La sezione Osservazioni.

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza su dependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Vedi anche

• TriggerBase
• Triggers
• Animazioni con storyboard per stati di visualizzazione
• Guida introduttiva: Modelli di controllo