Trigger Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Représente un déclencheur qui applique des valeurs de propriété ou effectue des actions de manière conditionnelle.

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

Héritage

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Attributs

ContentPropertyAttribute XamlSetTypeConverterAttribute

Implémente

IAddChild ISupportInitialize

Exemples

L’exemple suivant montre un nommé Style disponible pour Button les contrôles. Définit Style un Trigger élément qui modifie la Foreground propriété d’un bouton lorsque la IsPressed propriété est true.

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

Remarques

WPF définit des propriétés qui correspondent aux actions de l’utilisateur final, telles que la IsMouseOver propriété définie true sur lorsque l’utilisateur place le curseur sur un UIElement ou la propriété correspondante IsMouseOver d’un ContentElement. La représentation des actions de l’utilisateur final dans les valeurs de propriété, ainsi que l’élément Trigger , permet aux styles WPF de modifier les valeurs de propriété en fonction de ces actions de l’utilisateur final, le tout à partir du balisage.

Les propriétés modifiées par les déclencheurs sont automatiquement réinitialisées à leur valeur précédente lorsque la condition déclenchée n’est plus satisfaite. Les déclencheurs sont optimisés pour les états temporaires qui sont censés changer et revenir à l’état d’origine, tels que IsPressed sur Button et IsSelected sur ListBoxItem. L’élément Property d’intérêt doit être une propriété de dépendance.

Notez que vous devez spécifier les Property propriétés et Value sur un Trigger pour que le déclencheur soit significatif. Si l’une ou les deux propriétés ne sont pas définies, une exception est levée.

La Setters propriété d’un Trigger objet ne peut être constituée que d’objets Setter . L’ajout d’un Setter enfant à un Trigger objet l’ajoute implicitement au SetterBaseCollection pour l’objet Trigger . EventSetter les objets ne sont pas pris en charge ; Prend uniquement Style.Setters en charge les EventSetter objets.

Il existe d’autres types de déclencheurs. MultiTrigger vous permet d’appliquer des modifications en fonction de l’état de plusieurs propriétés. EventTrigger vous permet d’appliquer des modifications lorsqu’un événement se produit. DataTrigger et MultiDataTrigger s’adressent aux propriétés liées aux données.

Constructeurs

Trigger()

Initialise une nouvelle instance de la classe Trigger.

Propriétés

DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
EnterActions	Obtient une collection d’objets TriggerAction à appliquer quand l’objet de déclencheur devient actif. Cette propriété ne s’applique pas à la classe EventTrigger. (Hérité de TriggerBase)
ExitActions	Obtient une collection d’objets TriggerAction à appliquer quand l’objet déclencheur devient inactif. Cette propriété ne s’applique pas à la classe EventTrigger. (Hérité de TriggerBase)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
Property	Obtient ou définit la propriété qui retourne la valeur comparée avec la propriété Value du déclencheur. La comparaison est un contrôle de l'égalité de la référence.
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.
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.
Value	Obtient ou définit la valeur à comparer avec la valeur de propriété de l'élément. La comparaison est un contrôle de l'égalité de la référence.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. 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. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
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. (Hérité de DependencyObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
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. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Gère des cas où un convertisseur de type fournit une valeur pour une propriété d'un objet Trigger.
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
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. (Hérité de DependencyObject)
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. (Hérité de DependencyObject)
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. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)	Ajoute un objet enfant.
IAddChild.AddText(String)	Ajoute le contenu textuel d’un nœud à l’objet.
ISupportInitialize.BeginInit()	Signale à l'objet que l'initialisation démarre.
ISupportInitialize.EndInit()	Signale à l'objet que l'initialisation est terminée.