EventTrigger Třída

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Představuje trigger, který použije sadu akcí v reakci na událost.

public ref class EventTrigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Actions")]
public class EventTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Actions")>]
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild

Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild

Dědičnost

Object

DispatcherObject

DependencyObject

TriggerBase

EventTrigger

Atributy

ContentPropertyAttribute

Implementuje

IAddChild

Příklady

Tento příklad ukazuje, jak použít triggery událostí ve stylu k animaci MouseEnter událostí FrameworkElementa MouseLeave . V tomto příkladu má vlastnost Style nastavenou TargetType na Rectangle. Proto není nutné kvalifikovat MouseEnter názvy událostí a MouseLeave názvem třídy.

<Style TargetType="Rectangle">
  <Setter Property="Width" Value="50" />
  <Setter Property="Height" Value="50" />
  <Setter Property="Margin" Value="20" />
  <Setter Property="HorizontalAlignment" Value="Left" />
  <Style.Triggers>
    <EventTrigger RoutedEvent="MouseEnter">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation To="300" Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
    <EventTrigger RoutedEvent="MouseLeave">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
  </Style.Triggers>
</Style>

Poznámky

Trigger Objekty mají Settersvlastnosti , EnterActionsa ExitActions , které aplikují změny nebo akce na základě stavu určitých vlastností, zatímco EventTrigger objekty spustí sadu Actions , když dojde k zadané směrované události. Můžete například použít EventTrigger ke spuštění sady animací, když je ukazatel myši nad určitým ovládacím prvku uživatelského rozhraní. EventTrigger Na rozdíl od Triggerfunkce nemá žádný koncept ukončení stavu, takže akce nebude vrácena zpět, jakmile podmínka, která událost vyvolala, přestane platit.

Všimněte si, že při použití EventTriggernástroje musíte zvolit události, které nenarušují vlastní chování vašeho ovládacího prvku. Ovládací prvky, jako Button je nebo TextBox provádějí určité akce s událostmi vstupu uživatele, jako jsou kliknutí myší a události klávesnice. Pokud například vytváříte styl tlačítka a pokusíte se nastavit MouseDown událost na RoutedEventEventTriggerhodnotu , EventTrigger nikdy se nepoužije, protože událost nejprve zpracuje tlačítko . Místo toho můžete použít PreviewMouseDown událost nebo jinou událost.

Pokud používáte datovou vazbu a používáte TargetUpdated událost, musíte nastavit NotifyOnTargetUpdated hodnotu Binding objektu na hodnotu , true aby se událost vyvolala.

Přidání podřízeného TriggerAction objektu k objektu EventTrigger ho implicitně přidá do objektu TriggerActionCollectionEventTrigger pro objekt .

Konstruktory

EventTrigger()	Inicializuje novou instanci EventTrigger třídy .
EventTrigger(RoutedEvent)	Inicializuje novou instanci EventTrigger třídy se zadanou událostí.

Vlastnosti

Actions	Získá kolekci akcí, které se mají použít, když dojde k události.
DependencyObjectType	Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá to DispatcherDispatcherObject je přidružena k. (Zděděno od DispatcherObject)
EnterActions	Získá kolekci TriggerAction objektů, které se použijí při aktivaci objektu triggeru. Tato vlastnost se nevztahuje na EventTrigger třídu . (Zděděno od TriggerBase)
ExitActions	Získá kolekci TriggerAction objektů, které se použijí, když objekt triggeru se stane neaktivní. Tato vlastnost se nevztahuje na EventTrigger třídu . (Zděděno od TriggerBase)
IsSealed	Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
RoutedEvent	Získá nebo nastaví aktivační RoutedEvent událost, která aktivuje tuto aktivační událost.
SourceName	Získá nebo nastaví název objektu s událostí, která aktivuje tuto aktivační událost. Používají ho jenom triggery elementů nebo šablony.

Metody

AddChild(Object)	Přidá zadaný objekt do Actions kolekce aktuální aktivační události.
AddText(String)	Tato metoda není podporována a výsledkem je výjimka.
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která má být vymazána, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosáhne vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda zadaný DependencyObject je ekvivalentní k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolá se vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní změněná vlastnost závislosti je uvedena v datech události. (Zděděno od DependencyObject)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (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. (Zděděno od DependencyObject)
ShouldSerializeActions()	Vrátí, zda serializační procesy mají serializovat efektivní hodnotu Actions vlastnosti v instancích této třídy.
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Explicitní implementace rozhraní

IAddChild.AddChild(Object)	Přidá podřízený objekt.
IAddChild.AddText(String)	Přidá textový obsah uzlu do objektu .

Viz také

• EventSetter
• Úvod do ukázky stylů a šablon