Trigger Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

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 przypadku wartości włączonej Button i IsSelected włączonej 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.

Konstruktory

Trigger()

Inicjuje nowe wystąpienie klasy Trigger.

Właściwości

DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po 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. (Odziedziczone po 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. (Odziedziczone po TriggerBase)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po 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

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po 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. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po 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 . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
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. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po 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. (Odziedziczone po 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. (Odziedziczone po 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. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

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.

Zobacz też

• Wprowadzenie do przykładu stylów i tworzenia szablonów