EventTrigger Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un trigger che applica un set di azioni in risposta a un evento.
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
- Ereditarietà
- Attributi
- Implementazioni
Esempio
In questo esempio viene illustrato come usare i trigger di evento in uno stile per animare gli MouseEnter eventi e MouseLeave di un oggetto FrameworkElement. In questo esempio l'oggetto StyleTargetType è impostato su Rectangle. Pertanto, non è necessario qualificare i nomi degli MouseEnter eventi e MouseLeave con il nome della 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>
Commenti
Trigger Gli oggetti hanno le Settersproprietà , EnterActionse ExitActions che applicano modifiche o azioni in base allo stato di determinate proprietà, mentre EventTrigger gli oggetti iniziano un set di Actions quando si verifica un evento indirizzato specificato. Ad esempio, potresti voler usare un EventTrigger oggetto per avviare un set di animazioni quando il puntatore del mouse si trova su un determinato controllo dell'interfaccia utente. A differenza di Trigger, EventTrigger non ha alcun concetto di terminazione dello stato, quindi l'azione non verrà annullata una volta che la condizione che ha generato l'evento non è più true.
Si noti che quando si usa un EventTrigger, è necessario scegliere eventi che non interferiscono con il comportamento intrinseco del controllo. Controlli come Button o TextBox eseguono azioni specifiche su eventi di input dell'utente, ad esempio clic del mouse ed eventi della tastiera. Ad esempio, se si applica uno stile a un pulsante e si tenta di impostare l'evento MouseDown come RoutedEvent di un EventTriggeroggetto , l'evento EventTrigger non viene mai applicato perché l'evento viene gestito per primo dal pulsante. È invece possibile usare l'evento PreviewMouseDown o un evento diverso.
Quando si usa il data binding, se si usa l'evento TargetUpdated , è necessario impostare il NotifyOnTargetUpdated valore dell'oggetto su true per la generazione dell'eventoBinding.
L'aggiunta di un TriggerAction elemento figlio a un EventTrigger oggetto lo aggiunge in modo implicito all'oggetto TriggerActionCollection per l'oggetto EventTrigger .
Costruttori
| Nome | Descrizione |
|---|---|
| EventTrigger() |
Inizializza una nuova istanza della classe EventTrigger. |
| EventTrigger(RoutedEvent) |
Inizializza una nuova istanza della EventTrigger classe con l'evento specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Actions |
Ottiene la raccolta di azioni da applicare quando si verifica l'evento. |
| DependencyObjectType |
Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject) |
| Dispatcher |
Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject) |
| EnterActions |
Ottiene una raccolta di TriggerAction oggetti da applicare quando l'oggetto trigger diventa attivo. Questa proprietà non si applica alla EventTrigger classe . (Ereditato da TriggerBase) |
| ExitActions |
Ottiene una raccolta di TriggerAction oggetti da applicare quando l'oggetto trigger diventa inattivo. Questa proprietà non si applica alla EventTrigger classe . (Ereditato da TriggerBase) |
| IsSealed |
Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject) |
| RoutedEvent |
Ottiene o imposta l'oggetto RoutedEvent che attiverà questo trigger. |
| SourceName |
Ottiene o imposta il nome dell'oggetto con l'evento che attiva questo trigger. Questa operazione viene usata solo dai trigger di elemento o dai trigger del modello. |
Metodi
| Nome | Descrizione |
|---|---|
| AddChild(Object) |
Aggiunge l'oggetto specificato all'insieme Actions del trigger dell'evento corrente. |
| AddText(String) |
Questo metodo non è supportato e genera un'eccezione. |
| CheckAccess() |
Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject) |
| CoerceValue(DependencyProperty) |
Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject) |
| Equals(Object) |
Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject) |
| GetHashCode() |
Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject) |
| GetLocalValueEnumerator() |
Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject oggetto è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento. (Ereditato da DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject) |
| SetCurrentValue(DependencyProperty, Object) |
Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject) |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject) |
| ShouldSerializeActions() |
Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della Actions proprietà nelle istanze di questa classe. |
| ShouldSerializeProperty(DependencyProperty) |
Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| VerifyAccess() |
Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IAddChild.AddChild(Object) |
Aggiunge un oggetto figlio. |
| IAddChild.AddText(String) |
Aggiunge il contenuto di testo di un nodo all'oggetto . |