FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard Method

Определение

Начинает последовательность действий, содержащихся в предоставленной раскадровке.Begins the sequence of actions contained in the provided storyboard.

Перегрузки

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

Начинает последовательность действий, содержащихся в предоставленной раскадровке.Begins the sequence of actions that are contained in the provided storyboard.

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

Начинает последовательность действий, содержащихся в предоставленной раскадровке, с параметрами, указывающими на реакцию в случае уже анимированного свойства.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)

Начинает последовательность действий, содержащихся в предоставленной раскадровке, с указанным состоянием элемента управления анимацией после ее запуска.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)

Начинает последовательность действий, содержащихся в предоставленной раскадровке.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

Раскадровка, которая будет начата.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)

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

Раскадровка, которая будет начата.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Значение перечисления, описывающего поведение в случае, если описанное в раскадровке свойство уже анимировано.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.

Чтобы избежать проблем с производительностью при применении большого количества часов с помощью 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)

Начинает последовательность действий, содержащихся в предоставленной раскадровке, с указанным состоянием элемента управления анимацией после ее запуска.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

Раскадровка, которая будет начата.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Значение перечисления, описывающего поведение в случае, если описанное в раскадровке свойство уже анимировано.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.

Чтобы избежать проблем с производительностью при применении большого количества часов с помощью 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.

Применяется к