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 nom 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 les propriétés qui correspondent aux actions de l’utilisateur final, telles que la IsMouseOver propriété définie true lorsque l’utilisateur pointe le curseur sur un UIElement ou la propriété correspondante IsMouseOver d’un ContentElement. La représentation d’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, à 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, comme IsPressed activé et IsSelected activé ButtonListBoxItem. L’intérêt Property doit être une propriété de dépendance.

Notez que vous devez spécifier à la fois les propriétés et Value les Property propriétés d’un Trigger déclencheur pour qu’il soit significatif. Si 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 se composer que d’objets Setter . L’ajout d’un Setter enfant à un Trigger objet l’ajoute implicitement à l’objet SetterBaseCollectionTrigger . 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 concernent les propriétés liées aux données.

Constructeurs

Nom	Description
Trigger()	Initialise une nouvelle instance de la classe Trigger.

Propriétés

Nom	Description
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
EnterActions	Obtient une collection d’objets TriggerAction à appliquer lorsque l’objet déclencheur devient actif. Cette propriété ne s’applique pas à la EventTrigger classe. (Hérité de TriggerBase)
ExitActions	Obtient une collection d’objets TriggerAction à appliquer lorsque l’objet déclencheur devient inactif. Cette propriété ne s’applique pas à la EventTrigger classe. (Hérité de TriggerBase)
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
Property	Obtient ou définit la propriété qui retourne la valeur comparée à la Value propriété du déclencheur. La comparaison est un contrôle d’égalité de référence.
Setters	Obtient une collection d’objets, qui décrivent les valeurs de Setter propriété à appliquer lorsque la condition spécifiée a été remplie.
SourceName	Obtient ou définit le nom de l’objet avec la propriété qui entraîne l’application des setters associés.
Value	Obtient ou définit la valeur à comparer à la valeur de propriété de l’élément. La comparaison est un contrôle d’égalité de référence.

Méthodes

Nom	Description
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 un DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (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)
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)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Appelé chaque fois que la valeur effective d’une propriété de dépendance sur celle-ci 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, le cas échéant. (Hérité de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Gère les cas où un convertisseur de type fournit une valeur pour une propriété d’un Trigger objet.
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (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)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

Nom	Description
IAddChild.AddChild(Object)	Ajoute un objet enfant.
IAddChild.AddText(String)	Ajoute le contenu texte 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.