Trigger Trigger Trigger Trigger Class

Définition

Représente un déclencheur qui applique des valeurs de propriété ou effectue des actions sous conditions.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
Héritage
Attributs
Implémente

Exemples

L’exemple suivant montre une nommée Style disponibles pour Button contrôles.The following example shows a named Style available to Button controls. Le Style définit un Trigger élément qui change la Foreground propriété d’un bouton lorsque le IsPressed propriété est true.The 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>

Remarques

WPFWPF définit les propriétés qui correspondent aux actions de l’utilisateur final, tels que le IsMouseOver propriété a la valeur true lorsque l’utilisateur place le curseur sur un UIElement ou correspondant IsMouseOver propriété d’un 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. Qui représente les actions de l’utilisateur final dans les valeurs de propriété, ainsi que la Trigger permet de l’élément, WPFWPF styles pour modifier les valeurs de propriété à partir de ces actions de l’utilisateur final, tout à partir dans le balisage.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.

Les propriétés modifiées par les déclencheurs sont automatiquement rétablies à leur valeur précédente lorsque la condition de déclenchement n’est plus remplie.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. Les déclencheurs sont optimisés pour les états transitoires qui sont supposée changer et l’état de retour d’origine, tels que IsPressed sur Button et IsSelected sur ListBoxItem.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. Le Property d’intérêt doit être une propriété de dépendance.The Property of interest must be a dependency property.

Notez que vous devez spécifier à la fois le Property et Value propriétés sur un Trigger pour le déclencheur soit explicite.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Si un ou les deux propriétés ne sont pas définies, une exception est levée.If one or both of the properties are not set, an exception is thrown.

Le Setters propriété d’un Trigger objet peut contenir uniquement des Setter objets.The Setters property of a Trigger object can only consist of Setter objects. Ajout d’un Setter enfant à un Trigger objet ajoute implicitement à la SetterBaseCollection pour le Trigger objet.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter objets ne sont pas pris en charge ; uniquement Style.Setters prend en charge EventSetter objets.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Il existe d’autres types de déclencheurs.There are other types of triggers. MultiTrigger vous permet d’appliquer les modifications en fonction de l’état de plusieurs propriétés.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger vous permet d’appliquer des modifications lorsqu’un événement se produit.EventTrigger allows you to apply changes when an event occurs. DataTrigger et MultiDataTrigger concernent les propriétés liées aux données.DataTrigger and MultiDataTrigger are for data-bound properties.

Constructeurs

Trigger() Trigger() Trigger() Trigger()

Initialise une nouvelle instance de la classe Trigger.Initializes a new instance of the Trigger class.

Propriétés

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet de déclencheur devient actif.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Cette propriété ne s’applique pas à la classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

Obtient une collection d’objets TriggerAction à appliquer quand l’objet déclencheur devient inactif.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Cette propriété ne s’applique pas à la classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Property Property Property Property

Obtient ou définit la propriété qui retourne la valeur comparée avec la propriété Value du déclencheur.Gets or sets the property that returns the value that is compared with the Value property of the trigger. La comparaison est un contrôle de l'égalité de la référence.The comparison is a reference equality check.

Setters Setters Setters Setters

Obtient une collection d'objets Setter, qui décrivent les valeurs de propriété à appliquer lorsque la condition spécifiée a été rencontrée.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName SourceName SourceName SourceName

Obtient ou définit le nom de l'objet avec la propriété qui entraîne l'application des méthodes setter associées.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value Value Value Value

Obtient ou définit la valeur à comparer avec la valeur de propriété de l'élément.Gets or sets the value to be compared with the property value of the element. La comparaison est un contrôle de l'égalité de la référence.The comparison is a reference equality check.

Méthodes

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Réévalue la valeur effective pour la propriété de dépendance spécifiéeRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a été modifiée est signalée dans les données d'événement.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Gère des cas où un convertisseur de type fournit une valeur pour une propriété d'un objet Trigger.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Ajoute un objet enfant.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Ajoute le contenu textuel d’un nœud à l’objet.Adds the text content of a node to the object.

ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit()

Signale à l'objet que l'initialisation démarre.Signals the object that initialization is starting.

ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit()

Signale à l'objet que l'initialisation est terminée.Signals the object that initialization is complete.

S’applique à

Voir aussi