FrameworkContentElement.BeginStoryboard 메서드

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.

오버로드

BeginStoryboard(Storyboard)	제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.
BeginStoryboard(Storyboard, HandoffBehavior)	속성에 이미 애니메이션이 적용되어 있는 경우 수행할 작업에 대해 지정된 옵션을 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)	애니메이션이 시작된 후 제어하기 위한 지정된 상태를 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.

BeginStoryboard(Storyboard)

제공된 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

Public Sub BeginStoryboard (storyboard As Storyboard)

매개 변수

storyboard

Storyboard

시작할 Storyboard입니다.

설명

, 매개 변수를 사용하지 isControllable않는 서명의 경우 또는 해당 매개 변수를 지정false하면 애니메이션과 연결된 타임라인 클록이 "채우기" 기간에 도달하는 즉시 제거됩니다. 따라서 한 번 실행한 후 애니메이션을 다시 시작할 수 없습니다. 애니메이션을 제어하려면 스토리보드의 이름을 지정하거나 코드의 instance 액세스할 수 있어야 합니다.

BeginStoryboard(Storyboard, HandoffBehavior)

속성에 이미 애니메이션이 적용되어 있는 경우 수행할 작업에 대해 지정된 옵션을 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.

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

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)

매개 변수

storyboard

Storyboard

시작할 Storyboard입니다.

handoffBehavior

HandoffBehavior

Storyboard에 설명되어 있는 속성에 이미 애니메이션이 적용되어 있는 경우에 사용할 동작을 설명하는 열거형의 값입니다.

설명

, 매개 변수를 사용하지 isControllable않는 서명의 경우 또는 해당 매개 변수를 지정false하면 애니메이션과 연결된 타임라인 클록이 "채우기" 기간에 도달하는 즉시 제거됩니다. 따라서 한 번 실행한 후 애니메이션을 다시 시작할 수 없습니다. 애니메이션을 제어하려면 스토리보드의 이름을 지정하거나 코드의 instance 액세스할 수 있어야 합니다.

사용 하 여 Compose HandoffBehavior

를 사용하여 ComposeHandoffBehavior속성에 , AnimationTimeline또는 AnimationClock 를 적용Storyboard하는 경우 이전에 해당 속성과 연결된 모든 Clock 개체는 시스템 리소스를 계속 사용합니다. 타이밍 시스템은 클록을 자동으로 제거하지 않습니다.

를 사용하여 Compose많은 수의 클록을 적용할 때 성능 문제를 방지하려면 완료된 후 애니메이션 속성에서 작성 클록을 제거해야 합니다. 클록을 제거 하는 방법은 여러 가지가 있습니다.

• 속성에서 모든 클록을 제거 하려면 사용 합니다 ApplyAnimationClock(DependencyProperty, AnimationClock) 또는 BeginAnimation(DependencyProperty, AnimationTimeline) 애니메이션된 개체의 메서드. 첫 번째 매개 변수로 애니메이션 효과가 적용 되는 속성을 지정 하 고 null 두 번째입니다. 이 속성에서 모든 애니메이션 클록을 제거합니다.

• 특정 제거할 AnimationClock 클록 목록에서 사용 하 여는 Controller 의 속성을 AnimationClock 검색할를 ClockController, 호출를 Remove 메서드의 ClockController합니다. 이 일반적으로 수행 된 Completed 클록에 대 한 이벤트 처리기입니다. 루트 클록만 하 여 제어 될 수는 ClockController; Controller 자식 클록의 속성을 반환 null합니다. 또한 클록의 Completed 유효 기간이 영원히 지속되면 이벤트가 발생하지 않습니다. 이 경우 사용자 호출 시기를 결정 해야 Remove합니다.

이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다. 개체는 가비지 수집 되 면 해당 클록도 연결이 끊어집니다 및 가비지 수집 합니다.

클록 개체에 대 한 자세한 내용은 참조 하세요. 애니메이션 및 타이밍 시스템 개요합니다.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

애니메이션이 시작된 후 제어하기 위한 지정된 상태를 사용하여 제공된 Storyboard에 포함된 작업 시퀀스를 시작합니다.

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

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)

매개 변수

storyboard

Storyboard

시작할 Storyboard입니다.

handoffBehavior

HandoffBehavior

Storyboard에 설명되어 있는 속성에 이미 애니메이션이 적용되어 있는 경우에 사용할 동작을 설명하는 열거형의 값입니다.

isControllable

Boolean

애니메이션을 시작한 후 제어(일시 중지)할 수 있는지 여부를 선언합니다.

설명

, 매개 변수를 사용하지 isControllable않는 서명의 경우 또는 해당 매개 변수를 지정false하면 애니메이션과 연결된 타임라인 클록이 "채우기" 기간에 도달하는 즉시 제거됩니다. 따라서 한 번 실행한 후 애니메이션을 다시 시작할 수 없습니다. 애니메이션을 제어하려면 스토리보드의 이름을 지정하거나 코드의 instance 액세스할 수 있어야 합니다.

사용 하 여 Compose HandoffBehavior

를 사용하여 ComposeHandoffBehavior속성에 , AnimationTimeline또는 AnimationClock 를 적용Storyboard하는 경우 이전에 해당 속성과 연결된 모든 Clock 개체는 시스템 리소스를 계속 사용합니다. 타이밍 시스템은 이러한 클록을 자동으로 제거하지 않습니다.

를 사용하여 Compose많은 수의 클록을 적용할 때 성능 문제를 방지하려면 완료된 후 애니메이션 속성에서 작성 클록을 제거해야 합니다. 클록을 제거 하는 방법은 여러 가지가 있습니다.

• 속성에서 모든 클록을 제거 하려면 사용 합니다 ApplyAnimationClock(DependencyProperty, AnimationClock) 또는 BeginAnimation(DependencyProperty, AnimationTimeline) 애니메이션된 개체의 메서드. 첫 번째 매개 변수로 애니메이션 효과가 적용 되는 속성을 지정 하 고 null 두 번째입니다. 이 속성에서 모든 애니메이션 클록을 제거합니다.

• 특정 제거할 AnimationClock 클록 목록에서 사용 하 여는 Controller 의 속성을 AnimationClock 검색할를 ClockController, 호출를 Remove 메서드의 ClockController합니다. 이 일반적으로 수행 된 Completed 클록에 대 한 이벤트 처리기입니다. 루트 클록만 하 여 제어 될 수는 ClockController; Controller 자식 클록의 속성을 반환 null합니다. 또한 클록의 Completed 유효 기간이 영원히 지속되면 이벤트가 발생하지 않습니다. 이 경우 사용자 호출 시기를 결정 해야 Remove합니다.

이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다. 개체는 가비지 수집 되 면 해당 클록도 연결이 끊어집니다 및 가비지 수집 합니다.

클록 개체에 대 한 자세한 내용은 참조 하세요. 애니메이션 및 타이밍 시스템 개요합니다.