Trigger Klasa

Definicja

Namespace:

System.Windows

Montaż:

PresentationFramework.dll

Reprezentuje wyzwalacz, który stosuje wartości właściwości lub wykonuje akcje warunkowo.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Atrybuty

ContentPropertyAttribute XamlSetTypeConverterAttribute

Implementuje

IAddChild ISupportInitialize

Przykłady

W poniższym przykładzie przedstawiono nazwę Style dostępną dla Button kontrolek. Element Style definiuje Trigger element, który zmienia Foreground właściwość przycisku, gdy IsPressed właściwość to 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 właściwość ustawionatrue, gdy użytkownik umieści kursor na kursorze UIElement lub odpowiednią IsMouseOver właściwość elementu ContentElement.IsMouseOver Reprezentowanie akcji użytkownika końcowego w wartościach właściwości wraz z elementem umożliwia stylom WPF zmianę wartości właściwości na podstawie tych akcji użytkownika końcowego Trigger , wszystkie z poziomu znaczników.

Właściwości zmienione przez wyzwalacze są automatycznie resetowane do poprzedniej wartości, gdy wyzwalany warunek nie jest już spełniony. Wyzwalacze są zoptymalizowane pod kątem stanów przejściowych, które mają ulec zmianie i powrócić do stanu pierwotnego, na przykład IsPressed w systemie Button i IsSelected na ListBoxItem. Wartość Property procentowa musi być właściwością zależności.

Należy pamiętać, że należy określić właściwości Property i Value dla Trigger wyzwalacza, aby był zrozumiały. Jeśli jedna lub obie właściwości nie są ustawione, zgłaszany jest wyjątek.

Właściwość SettersTrigger obiektu może składać się tylko z Setter obiektów. Setter Dodanie elementu podrzędnego Trigger do obiektu niejawnie dodaje go do SetterBaseCollection obiektu dla Trigger obiektu . EventSetterobiekty nie są obsługiwane; obsługuje EventSetter tylko Style.Setters obiekty.

Istnieją inne typy wyzwalaczy. MultiTrigger umożliwia stosowanie zmian na podstawie stanu wielu właściwości. EventTrigger umożliwia stosowanie zmian w przypadku wystąpienia zdarzenia. DataTrigger i MultiDataTrigger są przeznaczone dla właściwości powiązanych z danymi.

Konstruktorów

Nazwa	Opis
Trigger()	Inicjuje nowe wystąpienie klasy Trigger.

Właściwości

Nazwa	Opis
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Dziedziczone od DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Dziedziczone od DispatcherObject)
EnterActions	Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się aktywny. Ta właściwość nie ma zastosowania do EventTrigger klasy. (Dziedziczone od TriggerBase)
ExitActions	Pobiera kolekcję TriggerAction obiektów do zastosowania, gdy obiekt wyzwalacza staje się nieaktywny. Ta właściwość nie ma zastosowania do EventTrigger klasy. (Dziedziczone od TriggerBase)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Dziedziczone od DependencyObject)
Property	Pobiera lub ustawia właściwość zwracającą wartość porównywaną z Value właściwością wyzwalacza. Porównanie jest sprawdzaniem równości odwołań.
Setters	Pobiera kolekcję Setter obiektów, które opisują wartości właściwości do zastosowania po spełnieniu określonego warunku.
SourceName	Pobiera lub ustawia nazwę obiektu z właściwością, która powoduje zastosowanie skojarzonych zestawów.
Value	Pobiera lub ustawia wartość do porównania z wartością właściwości elementu. Porównanie jest sprawdzaniem równości odwołań.

Metody

Nazwa	Opis
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Dziedziczone od DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Dziedziczone od DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Dziedziczone od DependencyObject)
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. 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, ponieważ istnieje w wywołaniu DependencyObject. (Dziedziczone od DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Dziedziczone od DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Dziedziczone od DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Dziedziczone od DependencyObject)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Dziedziczone od DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Dziedziczone od DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Dziedziczone od DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Dziedziczone od DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Obsługuje przypadki, w których konwerter typów zapewnia wartość właściwości Trigger obiektu.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Dziedziczone od DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Dziedziczone od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Dziedziczone od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Dziedziczone od DependencyObject)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Dziedziczone od DispatcherObject)

Implementacje interfejsów jawnych

Nazwa	Opis
IAddChild.AddChild(Object)	Dodaje obiekt podrzędny.
IAddChild.AddText(String)	Dodaje zawartość tekstową węzła do obiektu.
ISupportInitialize.BeginInit()	Sygnalizuje obiekt, który rozpoczyna inicjację.
ISupportInitialize.EndInit()	Sygnalizuje obiekt, który jest inicjowany.