FrameworkContentElement.BeginStoryboard 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
제공된 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합니다.
이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다. 개체는 가비지 수집 되 면 해당 클록도 연결이 끊어집니다 및 가비지 수집 합니다.
클록 개체에 대 한 자세한 내용은 참조 하세요. 애니메이션 및 타이밍 시스템 개요합니다.
적용 대상
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기