Trigger Klasse

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Trigger dar, der Eigenschaftswerte anwendet oder Aktionen bedingt ausführt.

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

Vererbung: Object

DispatcherObject

DependencyObject

TriggerBase
Trigger

Attribute: ContentPropertyAttribute XamlSetTypeConverterAttribute

Implementiert: IAddChild ISupportInitialize

Beispiele

Das folgende Beispiel zeigt einen Benannten, Style der für Button Steuerelemente verfügbar ist. Das Style definiert ein Trigger Element, das die Foreground Eigenschaft einer Schaltfläche ändert, wenn die IsPressed Eigenschaft lautet true.

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

Hinweise

WPF definiert Eigenschaften, die Endbenutzeraktionen entsprechen, z. B. die Eigenschaft, auf die IsMouseOver festgelegt true wird, wenn der Benutzer den Cursor über eine UIElement oder die entsprechende IsMouseOver Eigenschaft eines Objekts ContentElementbewegt. Die Darstellung von Endbenutzeraktionen in Eigenschaftswerten zusammen mit dem Trigger Element ermöglicht es WPF-Formatvorlagen, Eigenschaftswerte basierend auf diesen Endbenutzeraktionen zu ändern, und das alles innerhalb des Markups.

Die durch Trigger geänderten Eigenschaften werden automatisch auf ihren vorherigen Wert zurückgesetzt, wenn die ausgelöste Bedingung nicht mehr erfüllt ist. Trigger sind für vorübergehende Zustände optimiert, die erwartet werden, dass sie sich ändern und in den ursprünglichen Zustand zurückkehren, z IsPressed . B. ein Button - und IsSelected ein ListBoxItem. Das Property Interesse muss eine Abhängigkeitseigenschaft sein.

Beachten Sie, dass Sie sowohl die Eigenschaften als Value auch die Property Eigenschaften eines Trigger Triggers angeben müssen, damit er sinnvoll ist. Wenn eine oder beide Eigenschaften nicht festgelegt sind, wird eine Ausnahme ausgelöst.

Die Setters Eigenschaft eines Trigger Objekts kann nur aus Objekten bestehen Setter . Das Hinzufügen eines Setter untergeordneten Elements zu einem Trigger Objekt fügt es implizit dem SetterBaseCollection Objekt für das Trigger Objekt hinzu. EventSetterObjekte werden nicht unterstützt; unterstützt EventSetter nur Style.Setters Objekte.

Es gibt andere Arten von Triggern. MultiTrigger ermöglicht es Ihnen, Änderungen basierend auf dem Status mehrerer Eigenschaften anzuwenden. EventTrigger ermöglicht es Ihnen, Änderungen anzuwenden, wenn ein Ereignis auftritt. DataTrigger und MultiDataTrigger gelten für datengebundene Eigenschaften.

Konstruktoren

Name	Beschreibung
Trigger()	Initialisiert eine neue Instanz der Trigger-Klasse.

Eigenschaften

Name	Beschreibung
DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
EnterActions	Ruft eine Auflistung von TriggerAction Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt aktiv wird. Diese Eigenschaft gilt nicht für die EventTrigger Klasse. (Geerbt von TriggerBase)
ExitActions	Ruft eine Auflistung von TriggerAction Objekten ab, die angewendet werden sollen, wenn das Triggerobjekt inaktiv wird. Diese Eigenschaft gilt nicht für die EventTrigger Klasse. (Geerbt von TriggerBase)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)
Property	Dient zum Abrufen oder Festlegen der Eigenschaft, die den Wert zurückgibt, der mit der Value Eigenschaft des Triggers verglichen wird. Der Vergleich ist eine Referenzgleichstellungsprüfung.
Setters	Ruft eine Auflistung von Setter Objekten ab, die die Eigenschaftswerte beschreiben, die angewendet werden sollen, wenn die angegebene Bedingung erfüllt wurde.
SourceName	Dient zum Abrufen oder Festlegen des Namens des Objekts mit der Eigenschaft, die bewirkt, dass die zugeordneten Setter angewendet werden.
Value	Dient zum Abrufen oder Festlegen des Werts, der mit dem Eigenschaftswert des Elements verglichen werden soll. Der Vergleich ist eine Referenzgleichstellungsprüfung.

Methoden

Name	Beschreibung
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Behandelt Fälle, in denen ein Typkonverter einen Wert für eine Eigenschaft eines Trigger Objekts bereitstellt.
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IAddChild.AddChild(Object)	Fügt ein untergeordnetes Objekt hinzu.
IAddChild.AddText(String)	Fügt dem Objekt den Textinhalt eines Knotens hinzu.
ISupportInitialize.BeginInit()	Signalisiert das Objekt, das initialisiert wird.
ISupportInitialize.EndInit()	Signalisiert das Objekt, dass die Initialisierung abgeschlossen ist.

Gilt für:

Feedback

War diese Seite hilfreich?