Trigger Classe

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationFramework.dll

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 i valori delle proprietà o esegue azioni in modo condizionale.

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

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

[System.Windows.Markup.ContentProperty("Setters")]
public class Trigger : System.Windows.TriggerBase, 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")>]
type Trigger = class
    inherit TriggerBase
    interface IAddChild

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

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

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 i Button controlli. Style Definisce 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 proprietà che corrispondono alle azioni dell'utente finale, ad esempio la IsMouseOver proprietà impostata su true quando l'utente passa il cursore su un UIElement oggetto o la proprietà corrispondente IsMouseOver di un oggetto ContentElement. La rappresentazione delle 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, tutte dall'interno del markup.

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

Si noti che è necessario specificare entrambe le Property proprietà e Value in un Trigger affinché il trigger sia significativo. 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 Setter elemento figlio a un Trigger oggetto lo aggiunge in modo implicito all'oggetto SetterBaseCollection per l'oggetto 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 a dati.

Costruttori

Nome	Descrizione
Trigger()	Inizializza una nuova istanza della classe Trigger.

Proprietà

Nome	Descrizione
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher DispatcherObject 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)
Property	Ottiene o imposta la proprietà che restituisce il valore confrontato con la Value proprietà del trigger. Il confronto è un controllo di uguaglianza dei riferimenti.
Setters	Ottiene una raccolta di oggetti che descrivono i valori delle Setter proprietà da applicare quando la condizione specificata è stata soddisfatta.
SourceName	Ottiene o imposta il nome dell'oggetto con la proprietà che determina l'applicazione dei setter associati.
Value	Ottiene o imposta il valore da confrontare con il valore della proprietà dell'elemento. Il confronto è un controllo di uguaglianza dei riferimenti.

Metodi

Nome	Descrizione
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)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Gestisce i casi in cui un convertitore di tipi fornisce un valore per una proprietà di un Trigger oggetto .
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)
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 .
ISupportInitialize.BeginInit()	Segnala l'avvio dell'oggetto che l'inizializzazione è in corso.
ISupportInitialize.EndInit()	Segnala all'oggetto che l'inizializzazione è stata completata.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?