Trigger Classe

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Rappresenta un trigger che applica i valori delle proprietà o esegue azioni in modo condizionale.

public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Trigger : System.Windows.TriggerBase, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface IAddChild

Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize

Ereditarietà

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Attributi

ContentPropertyAttribute XamlSetTypeConverterAttribute

Implementazioni

IAddChild ISupportInitialize

Esempio

Nell'esempio seguente viene illustrato un oggetto denominato Style disponibile per Button i controlli. Definisce Style un Trigger elemento che modifica la Foreground proprietà di un pulsante quando la IsPressed proprietà è true.

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

Commenti

WPF definisce le proprietà corrispondenti alle azioni dell'utente finale, ad esempio la IsMouseOver proprietà impostata su true quando l'utente passa il puntatore del mouse su un UIElement oggetto o sulla proprietà corrispondente IsMouseOver di un ContentElementoggetto . Rappresentando le azioni dell'utente finale nei valori delle proprietà, insieme all'elemento Trigger , consente agli stili WPF di modificare i valori delle proprietà in base a tali azioni dell'utente finale, tutto dall'interno del markup.

Le proprietà modificate dai trigger vengono reimpostate automaticamente al valore precedente quando la condizione attivata non è più soddisfatta. I trigger sono ottimizzati per gli stati temporanei previsti per modificare e tornare allo stato originale, ad esempio IsPressed su Button e IsSelected su ListBoxItem. L'interesse Property deve essere una proprietà di dipendenza.

Si noti che è necessario specificare sia le Property proprietà e Value in un Trigger per consentire al trigger di essere significativi. Se una o entrambe le proprietà non sono impostate, viene generata un'eccezione.

La Setters proprietà di un Trigger oggetto può essere costituita solo da Setter oggetti. L'aggiunta di un elemento figlio a un Setter oggetto aggiunge in modo implicito all'oggetto SetterBaseCollectionTrigger .Trigger EventSettergli oggetti non sono supportati; supporta EventSetter solo Style.Setters oggetti.

Esistono altri tipi di trigger. MultiTrigger consente di applicare modifiche in base allo stato di più proprietà. EventTrigger consente di applicare modifiche quando si verifica un evento. DataTrigger e MultiDataTrigger sono per le proprietà associate ai dati.

Costruttori

Trigger()

Inizializza una nuova istanza della classe Trigger.

Proprietà

DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
EnterActions	Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa attivo. Questa proprietà non si applica alla classe EventTrigger. (Ereditato da TriggerBase)
ExitActions	Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa inattivo. Questa proprietà non si applica alla classe EventTrigger. (Ereditato da TriggerBase)
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Property	Ottiene o imposta la proprietà che restituisce il valore da confrontare con la proprietà Value del trigger. Il confronto è un controllo di uguaglianza dei riferimenti.
Setters	Ottiene un insieme di oggetti Setter che descrivono i valori della proprietà da applicare quando la condizione specificata è stata soddisfatta.
SourceName	Ottiene o imposta il nome dell'oggetto con la proprietà che causa l'applicazione dei metodi di impostazione associati.
Value	Ottiene o imposta il valore con cui confrontare il valore della proprietà dell'elemento. Il confronto è un controllo di uguaglianza dei riferimenti.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Gestisce casi dove un convertitore di tipo fornisce un valore per una proprietà di oggetto Trigger.
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo 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)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della 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 DispatcherObject. (Ereditato da DispatcherObject)

Implementazioni dell'interfaccia esplicita

IAddChild.AddChild(Object)	Aggiunge un oggetto figlio.
IAddChild.AddText(String)	Aggiunge il contenuto di testo di un nodo all'oggetto.
ISupportInitialize.BeginInit()	Segnala all'oggetto l'avvio dell'inizializzazione.
ISupportInitialize.EndInit()	Segnala all'oggetto che l'inizializzazione è completa.