Trigger Classe

Definizione

Rappresenta un trigger che applica i valori di proprietà o esegue azioni in modo condizionale.Represents a trigger that applies property values or performs actions conditionally.

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
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio seguente viene illustrato un Style oggetto denominato Button disponibile per i controlli.The following example shows a named Style available to Button controls. true IsPressed Definisce un Trigger elemento che modifica la Foreground proprietà di un pulsante quando la proprietà è. StyleThe Style defines a Trigger element that changes the Foreground property of a button when the IsPressed property is true.

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

Commenti

WPFWPFdefinisce le proprietà che corrispondono alle azioni dell'utente finale, ad esempio IsMouseOver la proprietà impostata su true quando l'utente passa il cursore su un UIElement oggetto o sulla proprietà corrispondente IsMouseOver di un oggetto ContentElement.defines properties that correspond to end-user actions, such as the IsMouseOver property that is set to true when the user hovers the cursor over a UIElement or the corresponding IsMouseOver property of a ContentElement. La rappresentazione delle azioni dell'utente finale nei valori delle Trigger proprietà, insieme all'elemento, consente WPFWPF agli stili di modificare i valori delle proprietà in base alle azioni dell'utente finale, dal markup.Representing end-user actions in property values, along with the Trigger element, allows WPFWPF styles to change property values based on those end-user actions, all from within markup.

Le proprietà modificate dai trigger vengono reimpostate automaticamente sul valore precedente quando la condizione attivata non è più soddisfatta.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. I trigger sono ottimizzati per gli stati temporanei che dovrebbero cambiare e tornare allo stato originale, IsPressed ad Button esempio IsSelected on ListBoxIteme on.Triggers are optimized for transient states which are expected to change and return to original state, such as IsPressed on Button and IsSelected on ListBoxItem. L' Property oggetto di interesse deve essere una proprietà di dipendenza.The Property of interest must be a dependency property.

Si noti che è necessario specificare entrambe Property le Value proprietà e su Trigger un oggetto affinché il trigger sia significativo.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Se una o entrambe le proprietà non sono impostate, viene generata un'eccezione.If one or both of the properties are not set, an exception is thrown.

La Setters proprietà di un Trigger oggetto può essere costituita Setter solo da oggetti.The Setters property of a Trigger object can only consist of Setter objects. L'aggiunta Setter di un elemento Trigger figlio a un oggetto lo aggiunge in SetterBaseCollection modo implicito a per l' Trigger oggetto.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSettergli oggetti non sono supportati. Style.Setters supportaEventSetter solo oggetti.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Sono disponibili altri tipi di trigger.There are other types of triggers. MultiTriggerconsente di applicare le modifiche in base allo stato di più proprietà.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTriggerconsente di applicare le modifiche quando si verifica un evento.EventTrigger allows you to apply changes when an event occurs. DataTriggere MultiDataTrigger sono per le proprietà con associazione a dati.DataTrigger and MultiDataTrigger are for data-bound properties.

Costruttori

Trigger()

Inizializza una nuova istanza della classe Trigger.Initializes a new instance of the Trigger class.

Proprietà

DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Ereditato da DependencyObject)
Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Ereditato da DispatcherObject)
EnterActions

Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa attivo.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Questa proprietà non si applica alla classe EventTrigger.This property does not apply to the EventTrigger class.

(Ereditato da TriggerBase)
ExitActions

Ottiene una raccolta di oggetti TriggerAction da applicare quando l'oggetto trigger diventa inattivo.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Questa proprietà non si applica alla classe EventTrigger.This property does not apply to the EventTrigger class.

(Ereditato da TriggerBase)
IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Ereditato da DependencyObject)
Property

Ottiene o imposta la proprietà che restituisce il valore da confrontare con la proprietà Value del trigger.Gets or sets the property that returns the value that is compared with the Value property of the trigger. Il confronto è un controllo di uguaglianza dei riferimenti.The comparison is a reference equality check.

Setters

Ottiene un insieme di oggetti Setter che descrivono i valori della proprietà da applicare quando la condizione specificata è stata soddisfatta.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName

Ottiene o imposta il nome dell'oggetto con la proprietà che causa l'applicazione dei metodi di impostazione associati.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value

Ottiene o imposta il valore con cui confrontare il valore della proprietà dell'elemento.Gets or sets the value to be compared with the property value of the element. Il confronto è un controllo di uguaglianza dei riferimenti.The comparison is a reference equality check.

Metodi

CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Ereditato da DependencyObject)
CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Ereditato da DependencyObject)
Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Ereditato da DependencyObject)
GetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.Gets a hash code for this DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento.The specific dependency property that changed is reported in the event data.

(Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.Returns the local value of a dependency property, if it exists.

(Ereditato da DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Gestisce casi dove un convertitore di tipo fornisce un valore per una proprietà di oggetto Trigger.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.Sets the value of a dependency property without changing its value source.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)

Implementazioni dell'interfaccia esplicita

IAddChild.AddChild(Object)

Aggiunge un oggetto figlio.Adds a child object.

IAddChild.AddText(String)

Aggiunge il contenuto di testo di un nodo all'oggetto.Adds the text content of a node to the object.

ISupportInitialize.BeginInit()

Segnala all'oggetto l'avvio dell'inizializzazione.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

Segnala all'oggetto che l'inizializzazione è completa.Signals the object that initialization is complete.

Si applica a

Vedi anche