Trigger Klasa

Definicja

Reprezentuje wyzwalacz, który stosuje wartości właściwości lub warunkowo wykonuje działania.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
public ref 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")]
public class Trigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface 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
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild
Dziedziczenie
Atrybuty
Implementuje

Przykłady

Poniższy przykład pokazuje nazwane Style dostępne dla Button kontrolek.The following example shows a named Style available to Button controls. StyleDefiniuje Trigger element, który zmienia Foreground Właściwość przycisku, gdy IsPressed Właściwość jest 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>

Uwagi

WPF definiuje właściwości, które odpowiadają akcjom użytkownika końcowego, takim jak IsMouseOver Właściwość, która jest ustawiona na, true gdy użytkownik umieści kursor nad UIElement lub odpowiadającą IsMouseOver właściwością ContentElement .WPF 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. Reprezentuje działania użytkownika końcowego w wartościach właściwości, wraz z Trigger elementem, umożliwia stylom WPF zmianę wartości właściwości w oparciu o te działania użytkownika końcowego, wszystkie z znaczników.Representing end-user actions in property values, along with the Trigger element, allows WPF styles to change property values based on those end-user actions, all from within markup.

Właściwości zmienione przez wyzwalacze są automatycznie resetowane do ich poprzedniej wartości, gdy wyzwalany warunek nie jest już spełniony.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. Wyzwalacze są zoptymalizowane pod kątem przejściowych Stanów, które należy zmienić i powrócić do stanu pierwotnego, IsPressed na przykład włączone Button i IsSelected włączone 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. PropertyOdsetki muszą być właściwością zależności.The Property of interest must be a dependency property.

Należy pamiętać, że należy określić Property właściwości i Value Trigger dla wyzwalacza, aby mieć znaczenie.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Jeśli nie ustawiono jednej lub obu właściwości, zostanie zgłoszony wyjątek.If one or both of the properties are not set, an exception is thrown.

SettersWłaściwość Trigger obiektu może składać się tylko z Setter obiektów.The Setters property of a Trigger object can only consist of Setter objects. Dodanie Setter elementu podrzędnego do Trigger obiektu niejawnie dodaje go do SetterBaseCollection Trigger obiektu.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter obiekty nie są obsługiwane; Style.Setters obsługuje tylko EventSetter obiekty.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Istnieją inne typy wyzwalaczy.There are other types of triggers. MultiTrigger umożliwia zastosowanie zmian w zależności od stanu wielu właściwości.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger umożliwia zastosowanie zmian w przypadku wystąpienia zdarzenia.EventTrigger allows you to apply changes when an event occurs. DataTrigger i MultiDataTrigger są dla właściwości powiązanych z danymi.DataTrigger and MultiDataTrigger are for data-bound properties.

Konstruktory

Trigger()

Inicjuje nowe wystąpienie klasy Trigger.Initializes a new instance of the Trigger class.

Właściwości

DependencyObjectType

Pobiera DependencyObjectType , który zawija typ CLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
EnterActions

Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza stanie się aktywny.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Ta właściwość nie ma zastosowania do EventTrigger klasy.This property does not apply to the EventTrigger class.

(Odziedziczone po TriggerBase)
ExitActions

Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się nieaktywny.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Ta właściwość nie ma zastosowania do EventTrigger klasy.This property does not apply to the EventTrigger class.

(Odziedziczone po TriggerBase)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
Property

Pobiera lub ustawia właściwość zwracającą wartość, która jest porównywana z Value właściwością wyzwalacza.Gets or sets the property that returns the value that is compared with the Value property of the trigger. Porównanie jest sprawdzaniem równości odwołań.The comparison is a reference equality check.

Setters

Pobiera kolekcję Setter obiektów, która opisuje wartości właściwości do zastosowania, gdy określony warunek został spełniony.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName

Pobiera lub ustawia nazwę obiektu z właściwością, która powoduje zastosowanie skojarzonych metod ustawiających.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value

Pobiera lub ustawia wartość do porównania z wartością właściwości elementu.Gets or sets the value to be compared with the property value of the element. Porównanie jest sprawdzaniem równości odwołań.The comparison is a reference equality check.

Metody

CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Obsługuje przypadki, w których konwerter typów udostępnia wartość właściwości Trigger obiektu.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)

Dodaje obiekt podrzędny.Adds a child object.

IAddChild.AddText(String)

Dodaje zawartość tekstową węzła do obiektu.Adds the text content of a node to the object.

ISupportInitialize.BeginInit()

Sygnalizuje obiekt, który uruchamia inicjalizację.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

Sygnalizuje obiekt, który zakończył inicjowanie.Signals the object that initialization is complete.

Dotyczy