EventTrigger Sınıf

Tanım

Bir olaya yanıt olarak bir dizi eylemi uygulayan bir tetikleyiciyi temsil eder.Represents a trigger that applies a set of actions in response to an event.

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
Devralma
Öznitelikler
Uygulamalar

Örnekler

Bu örnek, bir stil içindeki Olay tetikleyicilerinin ve olaylarına animasyon uygulamak için nasıl kullanılacağını gösterir MouseEnter MouseLeave FrameworkElement .This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. Bu örnekte,, Style TargetType olarak ayarlanır Rectangle .In this example, the Style has the TargetType set to Rectangle. Bu nedenle, MouseEnter ve MouseLeave olay adlarını sınıf adıyla nitelemeniz gerekmez.Therefore, there is no need to qualify the MouseEnter and MouseLeave event names with the class name.

<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>

Açıklamalar

Trigger nesneler, Setters EnterActions ExitActions belirli özelliklerin durumuna göre değişiklikler veya eylemler uygulayan,, ve özelliklerine sahiptir, ancak EventTrigger nesneler Actions belirtilen bir yönlendirilmiş olay gerçekleştiğinde bir kümesini başlatır.Trigger objects have the Setters, EnterActions, and ExitActions properties that apply changes or actions based on the state of certain properties, while EventTrigger objects start a set of Actions when a specified routed event occurs. Örneğin, EventTrigger fare işaretçisi belirli bir denetim üzerindeyken bir animasyon kümesini başlatmak için bir kullanmak isteyebilirsiniz kullanıcı arabirimi (UI)user interface (UI) .For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain kullanıcı arabirimi (UI)user interface (UI) control. Aksine Trigger , EventTrigger durum sonlandırması kavramı olmadığından, olayı oluşturan koşul artık doğru olmadığında eylem geri alınmaz.Unlike Trigger, EventTrigger has no concept of termination of state, so the action will not be undone once the condition that raised the event is no longer true.

Kullanırken EventTrigger , denetiminizin devralınan davranışına engel olmayan olayları seçmeniz gerektiğini unutmayın.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. Gibi denetimler Button veya TextBox fare tıklamaları ve klavye olayları gibi kullanıcı girişi olaylarında belirli eylemler gerçekleştirir.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. Örneğin, bir düğmeye stil oluşturuyorsanız ve MouseDown olayı bir olarak ayarlamaya çalışırsanız, RoutedEvent EventTrigger EventTrigger olay önce düğme tarafından işlendiği için hiçbir şekilde uygulanmaz.For example, if you are styling a button and try to set the MouseDown event as the RoutedEvent of an EventTrigger, the EventTrigger never gets applied because the event first gets handled by the button. Bunun yerine, PreviewMouseDown olayını veya farklı bir olayı kullanabilirsiniz.Instead, you can use the PreviewMouseDown event or a different event.

Veri bağlamayı kullanırken, TargetUpdated olayı kullanıyorsanız, NotifyOnTargetUpdated olay için bir değer olarak ayarlamanız gerekir Binding true .When using data binding, if you are using the TargetUpdated event, you must set the NotifyOnTargetUpdated value of your Binding object to true for the event to be raised.

TriggerActionBir nesneye alt öğe eklemek EventTrigger nesnenin öğesine örtülü olarak ekler TriggerActionCollection EventTrigger .Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Oluşturucular

EventTrigger()

EventTrigger sınıfının yeni bir örneğini başlatır.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent)

EventTriggerBelirtilen olayla birlikte sınıfının yeni bir örneğini başlatır.Initializes a new instance of the EventTrigger class with the specified event.

Özellikler

Actions

Olay gerçekleştiğinde uygulanacak eylemlerin koleksiyonunu alır.Gets the collection of actions to apply when the event occurs.

DependencyObjectType

DependencyObjectTypeBu örneğin türünü sarmalayan öğesini alır CLRCLR .Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Devralındığı yer: DependencyObject)
Dispatcher

Dispatcher DispatcherObject İle ilişkili olduğunu alır.Gets the Dispatcher this DispatcherObject is associated with.

(Devralındığı yer: DispatcherObject)
EnterActions

TriggerActionTetikleyici nesne etkin hale geldiğinde uygulanacak nesne koleksiyonunu alır.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Bu özellik EventTrigger sınıfına uygulanmaz.This property does not apply to the EventTrigger class.

(Devralındığı yer: TriggerBase)
ExitActions

TriggerActionTetikleyici nesne devre dışı olduğunda uygulanacak bir nesne koleksiyonu alır.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Bu özellik EventTrigger sınıfına uygulanmaz.This property does not apply to the EventTrigger class.

(Devralındığı yer: TriggerBase)
IsSealed

Bu örneğin şu anda kapalı olup olmadığını gösteren bir değer alır (salt okunurdur).Gets a value that indicates whether this instance is currently sealed (read-only).

(Devralındığı yer: DependencyObject)
RoutedEvent

RoutedEventBu tetikleyiciyi etkinleştirecek olan öğesini alır veya ayarlar.Gets or sets the RoutedEvent that will activate this trigger.

SourceName

Bu tetikleyiciyi etkinleştiren olayla birlikte nesnenin adını alır veya ayarlar.Gets or sets the name of the object with the event that activates this trigger. Bu yalnızca öğe Tetikleyicileri veya şablon Tetikleyicileri tarafından kullanılır.This is only used by element triggers or template triggers.

Yöntemler

AddChild(Object)

Belirtilen nesneyi Actions geçerli olay tetikleyicisi koleksiyonuna ekler.Adds the specified object to the Actions collection of the current event trigger.

AddText(String)

Bu yöntem desteklenmez ve bir özel durumla sonuçlanır.This method is not supported and results in an exception.

CheckAccess()

Çağıran iş parçacığının bu öğesine erişip erişemeyeceğini belirler DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)

Bir özelliğin yerel değerini temizler.Clears the local value of a property. Temizlenme özelliği bir tanımlayıcı tarafından belirtilir DependencyProperty .The property to be cleared is specified by a DependencyProperty identifier.

(Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)

Salt okunurdur özelliğinin yerel değerini temizler.Clears the local value of a read-only property. Temizlenme özelliği bir tarafından belirtilir DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Devralındığı yer: DependencyObject)
CoerceValue(DependencyProperty)

Belirtilen bağımlılık özelliğinin değerini zorlar.Coerces the value of the specified dependency property. Bu, CoerceValueCallback çağırma üzerinde olduğu gibi bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir işlevi çağırarak gerçekleştirilir DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Devralındığı yer: DependencyObject)
Equals(Object)

Belirtilen değerin geçerli olup olmadığını belirler DependencyObject DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Devralındığı yer: DependencyObject)
GetHashCode()

Bunun için bir karma kodu alır DependencyObject .Gets a hash code for this DependencyObject.

(Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()

Hangi bağımlılık özelliklerinin bunun üzerinde yerel olarak değer ayarlamış olduğunu belirlemek için özel bir Numaralandırıcı oluşturur DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Devralındığı yer: DependencyObject)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
GetValue(DependencyProperty)

Bir bağımlılık özelliğinin bu örneğine ait geçerli etkin değeri döndürür DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)

Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir.Re-evaluates the effective value for the specified dependency property.

(Devralındığı yer: DependencyObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Bunun üzerinde herhangi bir bağımlılık özelliğinin etkin değeri DependencyObject güncelleştirildiğinde çağrılır.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Değiştirilen belirli bağımlılık özelliği olay verilerinde raporlanır.The specific dependency property that changed is reported in the event data.

(Devralındığı yer: DependencyObject)
ReadLocalValue(DependencyProperty)

Varsa, bağımlılık özelliğinin yerel değerini döndürür.Returns the local value of a dependency property, if it exists.

(Devralındığı yer: DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar.Sets the value of a dependency property without changing its value source.

(Devralındığı yer: DependencyObject)
SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir Dependency özelliğinin yerel değerini ayarlar.Sets the local value of a dependency property, specified by its dependency property identifier.

(Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)

Bir salt okuma bağımlılığı özelliğinin yerel değerini, DependencyPropertyKey bağımlılık özelliğinin tanımlayıcısıyla belirtilen şekilde ayarlar.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Devralındığı yer: DependencyObject)
ShouldSerializeActions()

Serileştirme işlemlerinin, Actions Bu sınıfın örneklerinde özelliğin etkin değerini seri hale getirmesinin gerekip gerekmediğini döndürür.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty)

Serileştirme işlemlerinin, belirtilen bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini belirten bir değer döndürür.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Devralındığı yer: DependencyObject)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
VerifyAccess()

Çağıran iş parçacığının buna erişimi olmasını zorlar DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)

Belirtik Arabirim Kullanımları

IAddChild.AddChild(Object)

Bir alt nesne ekler.Adds a child object.

IAddChild.AddText(String)

Bir düğümün metin içeriğini nesneye ekler.Adds the text content of a node to the object.

Şunlara uygulanır

Ayrıca bkz.