FrameworkElement.BeginStoryboard Метод

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 при обработке внутреннего события.

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

Комментарии

Большинство типичных сценариев анимации не используют этот метод. Как правило, вы создаете элемент Storyboard или BeginStoryboard в разметке, а затем помещаем их в качестве содержимого EventTrigger в элемент. При активации события анимация запускается. Большинство аспектов элемента управления Storyboard можно устранить с помощью свойств, предоставляемых в разметке.

Для подписей, которые не используют isControllable, параметр или когда этот параметр указан false, временные часы временной шкалы, связанные с анимацией, удаляются, как только анимация достигает периода "Заливка". Поэтому анимация не может быть перезапущена после выполнения один раз. Для управления анимацией также требуется, чтобы раскадровка была директива x:Name или доступна по ссылке в коде.

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 при обработке внутреннего события.

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

Комментарии

Большинство типичных сценариев анимации не используют этот метод. Как правило, вы создаете элемент Storyboard или BeginStoryboard в разметке, а затем помещаем их в качестве содержимого EventTrigger в элемент. При активации события анимация запускается. Большинство аспектов элемента управления Storyboard можно устранить с помощью свойств, предоставляемых в разметке.

Для подписей, которые не используют isControllable, параметр или когда этот параметр указан false, временные часы временной шкалы, связанные с анимацией, удаляются, как только анимация достигает периода "Заливка". Поэтому анимация не может быть перезапущена после выполнения один раз. Для управления анимацией также требуется, чтобы раскадровка была директива x:Name или доступна по ссылке в коде.

Поведение передачи можно указать как атрибут BeginStoryboard.

Использование Compose HandoffBehavior

При применении Storyboard, AnimationTimelineили AnimationClock к свойству с помощью ComposeHandoffBehaviorвсе объекты Clock, ранее связанные с этим свойством, продолжают использовать системные ресурсы; Система времени не удаляет часы автоматически.

Чтобы избежать проблем с производительностью при применении большого количества часов с помощью Compose, следует удалить часы создания из анимированного свойства после их завершения. Существует несколько способов удаления часов:

• Чтобы удалить все часы из свойства, используйте метод ApplyAnimationClock(DependencyProperty, AnimationClock) или BeginAnimation(DependencyProperty, AnimationTimeline) анимированного объекта. Укажите анимированное свойство в качестве первого параметра и null в качестве второго. При этом удаляются все часы анимации из свойства.

• Чтобы удалить определенную AnimationClock из списка часов, используйте свойство ControllerAnimationClock для получения ClockController, а затем вызовите метод RemoveClockController. Обычно это делается в обработчике событий Completed для часов. Обратите внимание, что только корневые часы могут управляться ClockController; свойство Controller дочерних часов возвращает null. Обратите внимание также, что событие Completed не возникает, если эффективная длительность часов навсегда. В этом случае пользователь должен определить, когда следует вызывать Remove.

Это в первую очередь проблема анимации для объектов с длительным временем существования. Когда объект собирается мусор, его часы также отсоединяются и собираются мусор.

Дополнительные сведения о объектах часов см. в анимации и системе синхронизации.

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 или BeginStoryboard в разметке, а затем помещаем их в качестве содержимого EventTrigger в элемент. При активации события анимация запускается. Большинство аспектов элемента управления Storyboard можно устранить с помощью свойств, предоставляемых в разметке.

Для подписей, которые не используют isControllable, параметр или когда этот параметр указан false, временные часы временной шкалы, связанные с анимацией, удаляются, как только анимация достигает периода "Заливка". Поэтому анимация не может быть перезапущена после выполнения один раз. Для управления анимацией также требуется, чтобы раскадровка была директива x:Name или доступна по ссылке в коде.

Поведение передачи можно указать как атрибут BeginStoryboard.

Использование Compose HandoffBehavior

При применении Storyboard, AnimationTimelineили AnimationClock к свойству с помощью ComposeHandoffBehaviorвсе объекты Clock, ранее связанные с этим свойством, продолжают использовать системные ресурсы; Система времени не удаляет часы автоматически.

Чтобы избежать проблем с производительностью при применении большого количества часов с помощью Compose, следует удалить часы создания из анимированного свойства после их завершения. Существует несколько способов удаления часов:

• Чтобы удалить все часы из свойства, используйте метод ApplyAnimationClock(DependencyProperty, AnimationClock) или BeginAnimation(DependencyProperty, AnimationTimeline) анимированного объекта. Укажите анимированное свойство в качестве первого параметра и null в качестве второго. При этом удаляются все часы анимации из свойства.

• Чтобы удалить определенную AnimationClock из списка часов, используйте свойство ControllerAnimationClock для получения ClockController, а затем вызовите метод RemoveClockController. Обычно это делается в обработчике событий Completed для часов. Обратите внимание, что только корневые часы могут управляться ClockController; свойство Controller дочерних часов возвращает null. Обратите внимание также, что событие Completed не возникает, если эффективная длительность часов навсегда. В этом случае пользователь должен определить, когда следует вызывать Remove.

Это в первую очередь проблема анимации для объектов с длительным временем существования. Когда объект собирается мусор, его часы также отсоединяются и собираются мусор.

Дополнительные сведения о объектах часов см. в анимации и системе синхронизации.