EventTrigger 클래스

정의

네임스페이스:

Windows.UI.Xaml

이벤트에 대한 응답으로 작업 집합(애니메이션 스토리보드)을 적용하는 트리거를 나타냅니다. 일반적으로 사용되지 않습니다. 설명 부분을 참조하세요.

public ref class EventTrigger sealed : TriggerBase

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

<EventTrigger>
  oneOrMoreBeginStoryboards
</EventTrigger>
 

상속

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이 XAML 예제에서는 기본 FrameworkElement.Loaded 트리거 동작과 함께 FrameworkElement.Triggers를 사용하여 스토리보드 애니메이션을 실행하기 위한 기본 구조를 보여 줍니다. 이 XAML은 XAML 콘텐츠 속성 구문 및 생략된 불필요한 속성 요소 태그를 사용하여 각각과 적절한 관계에 있는 EventTrigger 및 BeginStoryboard 컨테이너 요소를 보여 줍니다.

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

설명

트리거, EventTrigger, Actions 및 BeginStoryboard 는 일반적으로 사용되지 않습니다. 이러한 API는 주로 Microsoft Silverlight에 사용된 XAML의 호환성을 위해 존재합니다. 이전에 이벤트 트리거를 사용한 대부분의 시나리오에서는 다음 중 하나를 수행합니다.

• 애니메이션 라이브러리의 기본 제공 애니메이션을 사용합니다. 빠른 시작: 애니메이션 라이브러리를 사용하여 UI 애니메이션을 참조하세요.
• 컨트롤 템플릿의 이벤트의 경우 시각적 상태 및 VisualStateManager를 사용합니다. 시각적 상태 또는 빠른 시작: 컨트롤 템플릿에 대한 스토리보드 애니메이션을 참조하세요.
• 앱별 UI 애니메이션의 경우 페이지에서 로드된 처리기를 정의합니다. 이 처리기는 페이지 수준 리소스에 정의된 Storyboard를 참조하고 해당 Storyboard에서 Begin 메서드를 호출할 수 있습니다. 스토리보드 애니메이션을 참조하세요.

트리거를 사용하도록 선택하는 경우 Windows 런타임 XAML에서 이벤트 트리거의 기본 동작과 EventTrigger를 호출하는 데 사용할 수 있는 유일한 이벤트는 FrameworkElement.Loaded입니다. 기본값이자 유일한 사용 동작이므로 RoutedEvent 특성을 설정하지 마세요. XAML <EventTrigger>을 사용하세요. RoutedEvent를 명시적으로 설정하는 경우(권장되지 않음) 작동하는 유일한 XAML은 입니다<EventTrigger RoutedEvent="FrameworkElement.Loaded">. 정규화되지 않은 "Loaded" 또는 다른 값은 구문 분석 예외를 throw합니다. 자세한 내용은 트리거를 참조하세요.

생성자

EventTrigger()

EventTrigger 클래스의 새 instance 초기화합니다.

속성

Actions	이 EventTrigger에서 유지 관리하는 BeginStoryboard 개체의 컬렉션을 가져옵니다.
Dispatcher	이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작되더라도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject)
RoutedEvent	트리거를 시작하는 이벤트의 이름을 가져오거나 설정합니다. 일반적으로 설정되지 않은 경우 비고를 참조하세요.

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject instance 특정 DependencyProperty에 대한 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject에 대한 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

추가 정보

• TriggerBase
• Triggers
• 시각적 상태에 대한 스토리보드 애니메이션
• 빠른 시작: 컨트롤 템플릿