EventTrigger EventTrigger EventTrigger EventTrigger Class

정의

이벤트에 대한 응답으로 작업 집합을 적용하는 트리거를 나타냅니다.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
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild
Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild
상속
특성
구현

예제

스타일에서 이벤트 트리거를 사용 하 여 애니메이션 효과 적용 하는 방법을 보여 주는이 예제는 MouseEnter 하 고 MouseLeave 의 이벤트를 FrameworkElement.This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. 이 예제에서는 합니다 StyleTargetTypeRectangle합니다.In this example, the Style has the TargetType set to Rectangle. 따라서 한정 하지 않아도 됩니다 합니다 MouseEnterMouseLeave 클래스 이름으로 이벤트 이름입니다.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>

설명

Trigger 개체는 Setters, EnterActions, 및 ExitActions 변경 하거나 특정 속성의 상태에 따라 작업에 적용 되는 속성 동안 EventTrigger 개체의 집합을 시작 Actions 지정된 된 라우트된 이벤트가 발생할 때.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. 사용 하려는 예는 EventTrigger 마우스 포인터를 특정 위로 가져갈 때 애니메이션의 집합을 시작 하려면 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 UI(사용자 인터페이스)user interface (UI) control. 와 달리 Trigger, EventTrigger 종료 상태에 대 한 개념이 이벤트를 발생 시킨 조건이 더 이상 true 면 작업은 실행 취소할 되지 것입니다.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.

사용할 때는 EventTrigger, 작업 컨트롤의 고유한 동작을 사용 하 여 방해 하지 않는 이벤트를 선택 해야 합니다.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. 와 같은 컨트롤 Button 또는 TextBox 마우스 클릭 같은 사용자 입력된 이벤트에서 특정 작업을 수행 하 고 키보드 이벤트입니다.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. 예를 들어 단추에 스타일을 지정 하 고 설정 하 려 합니다 MouseDown 이벤트를 RoutedEventEventTrigger, EventTrigger 이벤트 단추에서 먼저 처리 하기 때문에 적용 되지 않습니다.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. 대신 사용할 수는 PreviewMouseDown 이벤트 또는 다른 이벤트입니다.Instead, you can use the PreviewMouseDown event or a different event.

사용 중인 경우 데이터 바인딩을 사용 하는 경우는 TargetUpdated 설정한 이벤트를 NotifyOnTargetUpdated 값에 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.

추가 TriggerAction 에 대 한 자식은 EventTrigger 개체가 암시적으로 추가 합니다 TriggerActionCollection 에 대 한를 EventTrigger 개체입니다.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

생성자

EventTrigger() EventTrigger() EventTrigger() EventTrigger()

EventTrigger 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent)

지정된 이벤트를 사용하여 EventTrigger 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the EventTrigger class with the specified event.

속성

Actions Actions Actions Actions

이벤트가 발생할 때 적용할 작업의 컬렉션을 가져옵니다.Gets the collection of actions to apply when the event occurs.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

이 인스턴스의 CLRCLR 형식을 래핑하는 DependencyObjectType을 가져옵니다.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Dispatcher와 연결된 DispatcherObject를 가져옵니다.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

트리거 개체가 활성화될 때 적용할 TriggerAction 개체의 컬렉션을 가져옵니다.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. 이 속성은 EventTrigger 클래스에 적용되지 않습니다.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

트리거 개체가 비활성화될 때 적용할 TriggerAction 개체의 컬렉션을 가져옵니다.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. 이 속성은 EventTrigger 클래스에 적용되지 않습니다.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
RoutedEvent RoutedEvent RoutedEvent RoutedEvent

이 트리거를 활성화할 RoutedEvent를 가져오거나 설정합니다.Gets or sets the RoutedEvent that will activate this trigger.

SourceName SourceName SourceName SourceName

이 트리거를 활성화하는 이벤트를 사용하여 개체의 이름을 가져오거나 설정합니다.Gets or sets the name of the object with the event that activates this trigger. 요소 트리거 또는 템플릿 트리거에서만 사용됩니다.This is only used by element triggers or template triggers.

메서드

AddChild(Object) AddChild(Object) AddChild(Object) AddChild(Object)

지정된 개체를 현재 이벤트 트리거의 Actions 컬렉션에 추가합니다.Adds the specified object to the Actions collection of the current event trigger.

AddText(String) AddText(String) AddText(String) AddText(String)

이 메서드는 지원되지 않으며 이 메서드를 호출하면 예외가 발생합니다.This method is not supported and results in an exception.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

속성의 로컬 값을 지웁니다.Clears the local value of a property. 지울 속성이 DependencyProperty 식별자에서 지정됩니다.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

읽기 전용 속성의 로컬 값을 지웁니다.Clears the local value of a read-only property. 선언할 속성이 DependencyPropertyKey에서 지정됩니다.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

지정된 종속성 속성의 값을 강제 변환합니다.Coerces the value of the specified dependency property. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

DependencyObject의 해시 코드를 가져옵니다.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

DependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

DependencyObject의 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

지정된 종속성 속성의 유효 값을 다시 계산합니다.Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

DependencyObject에서 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 변경된 특정 종속성 속성은 이벤트 데이터에서 보고됩니다.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

종속성 속성의 로컬 값을 반환합니다(있는 경우).Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

해당 값 소스를 변경하지 않고 종속성 속성의 값을 설정합니다.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions()

serialization 프로세스가 이 클래스의 인스턴스에 있는 Actions 속성의 효과적인 값을 직렬화하는지 여부를 반환합니다.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

serialization 프로세스에서 지정된 종속성 속성의 값을 직렬화해야 하는지 여부를 나타내는 값을 반환합니다.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

명시적 인터페이스 구현

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

자식 개체를 추가합니다.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

노드의 텍스트 콘텐츠를 개체에 추가합니다.Adds the text content of a node to the object.

적용 대상

추가 정보