FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard Method

정의

제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions contained in the provided storyboard.

오버로드

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions that are contained in the provided storyboard.

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

속성에 이미 애니메이션이 적용되어 있는 경우 수행할 작업에 대해 지정된 옵션을 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions contained in the provided storyboard, with options specified for what should happen if the property is already animated.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

애니메이션이 시작된 후 제어하기 위한 지정된 상태를 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions that are contained in the provided storyboard.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unit

매개 변수

storyboard
Storyboard Storyboard Storyboard

시작할 Storyboard입니다.The storyboard to begin.

예제

다음 예제에서는 검색 된 Storyboard 리소스에서는 실행 하 고 Storyboard 내부 이벤트를 처리 하는 클래스를가 하는 경우.The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
	Dim s As Storyboard

	s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
	Me.BeginStoryboard(s)
End Sub

설명

가장 일반적인 애니메이션 시나리오에서이 메서드를 사용 하지 마십시오.Most typical animation scenarios do not use this method. 일반적으로 Storyboard 또는 BeginStoryboard 태그 및 다음 요소에 배치는 EventTrigger 요소 콘텐츠입니다.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. 이벤트에 의해 트리거되면 다음 애니메이션 실행 됩니다.When triggered by the event, the animation then runs. 대부분의 컨트롤 측면을 Storyboard 태그에서 노출 된 속성을 통해 해결할 수 있습니다.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

사용 하지 않는 서명에 대 한 합니다 isControllable, 매개 변수를 해당 매개 변수를 지정 하는 경우 또는 false, 연결 된 애니메이션 타임 라인 시계 애니메이션 "Fill" 기간에 도달 하는 즉시 제거 됩니다.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. 따라서 애니메이션을 한 번 실행 한 후에 다시 시작할 수 없습니다.Therefore the animation cannot be restarted after running once. 애니메이션 제어 수도 있어야 스토리 보드를 X:name 지시문 코드에서 참조 하 여 액세스할 수 있습니다.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

속성에 이미 애니메이션이 적용되어 있는 경우 수행할 작업에 대해 지정된 옵션을 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions contained in the provided storyboard, with options specified for what should happen if the property is already animated.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unit

매개 변수

storyboard
Storyboard Storyboard Storyboard

시작할 Storyboard입니다.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Storyboard에 설명되어 있는 속성에 이미 애니메이션이 적용되어 있는 경우에 사용할 동작을 설명하는 열거형의 값입니다.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

예제

다음 예제에서는 검색 된 Storyboard 리소스에서는 실행 하 고 Storyboard 내부 이벤트를 처리 하는 클래스를가 하는 경우.The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
	Dim s As Storyboard

	s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
	Me.BeginStoryboard(s)
End Sub

설명

가장 일반적인 애니메이션 시나리오에서이 메서드를 사용 하지 마십시오.Most typical animation scenarios do not use this method. 일반적으로 Storyboard 또는 BeginStoryboard 태그 및 다음 요소에 배치는 EventTrigger 요소 콘텐츠입니다.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. 이벤트에 의해 트리거되면 다음 애니메이션 실행 됩니다.When triggered by the event, the animation then runs. 대부분의 컨트롤 측면을 Storyboard 태그에서 노출 된 속성을 통해 해결할 수 있습니다.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

사용 하지 않는 서명에 대 한 합니다 isControllable, 매개 변수를 해당 매개 변수를 지정 하는 경우 또는 false, 연결 된 애니메이션 타임 라인 시계 애니메이션 "Fill" 기간에 도달 하는 즉시 제거 됩니다.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. 따라서 애니메이션을 한 번 실행 한 후에 다시 시작할 수 없습니다.Therefore the animation cannot be restarted after running once. 애니메이션 제어 수도 있어야 스토리 보드를 X:name 지시문 코드에서 참조 하 여 액세스할 수 있습니다.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

핸드 오프 동작 특성으로 지정할 수 있습니다 BeginStoryboard합니다.Handoff behavior can be specified as an attribute of BeginStoryboard.

사용 하 여 Compose HandoffBehaviorUsing the Compose HandoffBehavior

적용 하는 경우는 Storyboard, AnimationTimeline, 또는 AnimationClock 사용 하 여 속성에는 Compose HandoffBehavior모든 Clock 개체 속성과 연관 된 이전에 시스템 리소스를 소비 계속; 타이밍 시스템에서 시계를 자동으로 제거 하지 않습니다.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

사용 하 여 많은 수의 clock 적용 하는 경우 성능 문제를 방지 하려면 Compose를 완성 한 후 애니메이션된 속성에서 구성 중인 클록을 제거 해야 합니다.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. 클록을 제거 하는 방법은 여러 가지가 있습니다.There are several ways to remove a clock:

이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다.This is primarily an issue for animations on objects that have a long lifetime. 개체는 가비지 수집 되 면 해당 클록도 연결이 끊어집니다 및 가비지 수집 합니다.When an object is garbage collected, its clocks are also disconnected and garbage collected.

클록 개체에 대 한 자세한 내용은 참조 하세요. 애니메이션 및 타이밍 시스템 개요합니다.For more information about clock objects, see Animation and Timing System Overview.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

애니메이션이 시작된 후 제어하기 위한 지정된 상태를 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unit

매개 변수

storyboard
Storyboard Storyboard Storyboard

시작할 Storyboard입니다.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Storyboard에 설명되어 있는 속성에 이미 애니메이션이 적용되어 있는 경우에 사용할 동작을 설명하는 열거형의 값입니다.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean Boolean Boolean

애니메이션을 시작한 후 제어(일시 중지)할 수 있는지 여부를 선언합니다.Declares whether the animation is controllable (can be paused) after it is started.

설명

가장 일반적인 애니메이션 시나리오에서이 메서드를 사용 하지 마십시오.Most typical animation scenarios do not use this method. 일반적으로 Storyboard 또는 BeginStoryboard 태그 및 다음 요소에 배치는 EventTrigger 요소 콘텐츠입니다.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. 이벤트에 의해 트리거되면 다음 애니메이션 실행 됩니다.When triggered by the event, the animation then runs. 대부분의 컨트롤 측면을 Storyboard 태그에서 노출 된 속성을 통해 해결할 수 있습니다.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

사용 하지 않는 서명에 대 한 합니다 isControllable, 매개 변수를 해당 매개 변수를 지정 하는 경우 또는 false, 연결 된 애니메이션 타임 라인 시계 애니메이션 "Fill" 기간에 도달 하는 즉시 제거 됩니다.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. 따라서 애니메이션을 한 번 실행 한 후에 다시 시작할 수 없습니다.Therefore the animation cannot be restarted after running once. 애니메이션 제어 수도 있어야 스토리 보드를 X:name 지시문 코드에서 참조 하 여 액세스할 수 있습니다.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

핸드 오프 동작 특성으로 지정할 수 있습니다 BeginStoryboard합니다.Handoff behavior can be specified as an attribute of BeginStoryboard.

사용 하 여 Compose HandoffBehaviorUsing the Compose HandoffBehavior

적용 하는 경우는 Storyboard, AnimationTimeline, 또는 AnimationClock 사용 하 여 속성에는 Compose HandoffBehavior모든 Clock 개체 속성과 연관 된 이전에 시스템 리소스를 소비 계속; 타이밍 시스템에서 시계를 자동으로 제거 하지 않습니다.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

사용 하 여 많은 수의 clock 적용 하는 경우 성능 문제를 방지 하려면 Compose를 완성 한 후 애니메이션된 속성에서 구성 중인 클록을 제거 해야 합니다.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. 클록을 제거 하는 방법은 여러 가지가 있습니다.There are several ways to remove a clock:

이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다.This is primarily an issue for animations on objects that have a long lifetime. 개체는 가비지 수집 되 면 해당 클록도 연결이 끊어집니다 및 가비지 수집 합니다.When an object is garbage collected, its clocks are also disconnected and garbage collected.

클록 개체에 대 한 자세한 내용은 참조 하세요. 애니메이션 및 타이밍 시스템 개요합니다.For more information about clock objects, see Animation and Timing System Overview.

적용 대상