Trigger Třída

Definice

Představuje Trigger, který aplikuje hodnoty vlastností nebo provádí akce podmíněně.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
Dědičnost
Atributy
Implementuje

Příklady

Následující příklad ukazuje pojmenovaný Style k dispozici pro Button ovládací prvky.The following example shows a named Style available to Button controls. StyleDefinuje Trigger prvek, který změní Foreground vlastnost tlačítka, když IsPressed je vlastnost 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>

Poznámky

WPF definuje vlastnosti, které odpovídají akcím koncových uživatelů, jako je například IsMouseOver vlastnost, která je nastavena na hodnotu, true když uživatel najede myší na ukazatel UIElement nebo na odpovídající IsMouseOver vlastnost 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. Představují-li akce koncového uživatele v hodnotách vlastností společně s Trigger elementem, umožňuje stylům WPF měnit hodnoty vlastností na základě těchto akcí koncových uživatelů, a to vše v rámci značek.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.

Vlastnosti změněné triggery jsou automaticky obnoveny na předchozí hodnotu, pokud je aktivační podmínka již nesplněna.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. Aktivační události jsou optimalizované pro přechodné stavy, u kterých se očekává změna a návrat do původního stavu, například IsPressed zapnuto Button a IsSelected zapnuto 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. PropertyÚrok musí být vlastnost závislosti.The Property of interest must be a dependency property.

Všimněte si, že je nutné zadat Property Jak Value vlastnosti, tak Trigger pro aktivační událost, aby byly smysluplné.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Pokud jedna nebo obě vlastnosti nejsou nastaveny, je vyvolána výjimka.If one or both of the properties are not set, an exception is thrown.

SettersVlastnost Trigger objektu může obsahovat pouze Setter objekty.The Setters property of a Trigger object can only consist of Setter objects. Pokud přidáte Setter podřízenou položku Trigger objektu, implicitně ji přidáte do SetterBaseCollection objektu pro Trigger objekt.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter objekty nejsou podporovány. Style.Setters podporuje pouze EventSetter objekty.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Existují další typy triggerů.There are other types of triggers. MultiTrigger umožňuje použít změny v závislosti na stavu více vlastností.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger umožňuje použít změny, když dojde k události.EventTrigger allows you to apply changes when an event occurs. DataTrigger a MultiDataTrigger jsou pro vlastnosti vázané na data.DataTrigger and MultiDataTrigger are for data-bound properties.

Konstruktory

Trigger()

Inicializuje novou instanci Trigger třídy.Initializes a new instance of the Trigger class.

Vlastnosti

DependencyObjectType

Získá DependencyObjectType , který zabalí typ CLR této instance.Gets the DependencyObjectType that wraps the CLR type of this instance.

(Zděděno od DependencyObject)
Dispatcher

Získá Dispatcher přidružený k DispatcherObject .Gets the Dispatcher this DispatcherObject is associated with.

(Zděděno od DispatcherObject)
EnterActions

Získá kolekci TriggerAction objektů, které se mají použít, když se objekt triggeru stane aktivním.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Tato vlastnost se nevztahuje na EventTrigger třídu.This property does not apply to the EventTrigger class.

(Zděděno od TriggerBase)
ExitActions

Získá kolekci TriggerAction objektů, které se mají použít, když se objekt triggeru stane neaktivní.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Tato vlastnost se nevztahuje na EventTrigger třídu.This property does not apply to the EventTrigger class.

(Zděděno od TriggerBase)
IsSealed

Načte hodnotu, která označuje, jestli je tato instance aktuálně zapečetěná (jen pro čtení).Gets a value that indicates whether this instance is currently sealed (read-only).

(Zděděno od DependencyObject)
Property

Získá nebo nastaví vlastnost, která vrátí hodnotu, která je porovnána s Value vlastností triggeru.Gets or sets the property that returns the value that is compared with the Value property of the trigger. Porovnání je odkazem na kontrolu rovnosti.The comparison is a reference equality check.

Setters

Získá kolekci Setter objektů, které popisují hodnoty vlastností, které se mají použít při splnění zadané podmínky.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName

Získá nebo nastaví název objektu s vlastností, která způsobuje, že jsou přidružené metody setter aplikovány.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value

Získá nebo nastaví hodnotu, která se má porovnat s hodnotou vlastnosti elementu.Gets or sets the value to be compared with the property value of the element. Porovnání je odkazem na kontrolu rovnosti.The comparison is a reference equality check.

Metody

CheckAccess()

Určuje, zda má volající vlákno přístup DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Zděděno od DispatcherObject)
ClearValue(DependencyProperty)

Vymaže místní hodnotu vlastnosti.Clears the local value of a property. Vlastnost, která má být vyčištěna, je určena DependencyProperty identifikátorem.The property to be cleared is specified by a DependencyProperty identifier.

(Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)

Vymaže místní hodnotu vlastnosti jen pro čtení.Clears the local value of a read-only property. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Zděděno od DependencyObject)
CoerceValue(DependencyProperty)

Převede hodnotu zadané vlastnosti závislosti.Coerces the value of the specified dependency property. To se provádí vyvoláním jakékoli CoerceValueCallback funkce určené v metadatech vlastnosti pro vlastnost závislosti, protože existuje při volání DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Zděděno od DependencyObject)
Equals(Object)

Určuje, zda je poskytnutý DependencyObject ekvivalent aktuální DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Zděděno od DependencyObject)
GetHashCode()

Získá kód hodnoty hash DependencyObject .Gets a hash code for this DependencyObject.

(Zděděno od DependencyObject)
GetLocalValueEnumerator()

Vytvoří specializovaný enumerátor pro zjištění, které vlastnosti závislosti mají lokálně nastavené hodnoty DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Zděděno od DependencyObject)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
GetValue(DependencyProperty)

Vrátí aktuální platnou hodnotu vlastnosti závislosti v této instanci DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)

Znovu vyhodnotí platnou hodnotu pro zadanou vlastnost závislosti.Re-evaluates the effective value for the specified dependency property.

(Zděděno od DependencyObject)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Vyvolá se vždy, když byla aktualizována skutečná hodnota jakékoli vlastnosti závislosti DependencyObject .Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Konkrétní vlastnost závislosti, která se změnila, je uvedena v datech události.The specific dependency property that changed is reported in the event data.

(Zděděno od DependencyObject)
ReadLocalValue(DependencyProperty)

Vrátí místní hodnotu vlastnosti závislosti, pokud existuje.Returns the local value of a dependency property, if it exists.

(Zděděno od DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Zpracovává případy, kde konvertor typu poskytuje hodnotu pro vlastnost Trigger objektu.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object)

Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty.Sets the value of a dependency property without changing its value source.

(Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)

Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti.Sets the local value of a dependency property, specified by its dependency property identifier.

(Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)

Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Vrátí hodnotu, která označuje, zda mají procesy serializace serializovat hodnotu pro poskytnutou vlastnost závislosti.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Zděděno od DependencyObject)
ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
VerifyAccess()

Vynutilo, aby volající vlákno měl přístup DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Zděděno od DispatcherObject)

Explicitní implementace rozhraní

IAddChild.AddChild(Object)

Přidá podřízený objekt.Adds a child object.

IAddChild.AddText(String)

Přidá textový obsah uzlu do objektu.Adds the text content of a node to the object.

ISupportInitialize.BeginInit()

Signalizuje objekt, který se spouští při inicializaci.Signals the object that initialization is starting.

ISupportInitialize.EndInit()

Signalizuje dokončení objektu, který se inicializuje.Signals the object that initialization is complete.

Platí pro