FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard Method

Definición

Empieza la secuencia de acciones contenidas en el guión gráfico proporcionado.Begins the sequence of actions contained in the provided storyboard.

Sobrecargas

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

Empieza la secuencia de acciones contenidas en el guión gráfico proporcionado.Begins the sequence of actions that are contained in the provided storyboard.

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

Comienza la secuencia de acciones contenidas en el guión gráfico proporcionado, con opciones especificadas para lo que debería ocurrir si la propiedad ya está animada.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)

Comienza la secuencia de acciones contenidas en el guión gráfico proporcionado, con el estado especificado para el control de la animación una vez iniciado.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)

Empieza la secuencia de acciones contenidas en el guión gráfico proporcionado.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

Parámetros

storyboard
Storyboard Storyboard Storyboard

Guión gráfico que se va a iniciar.The storyboard to begin.

Ejemplos

En el ejemplo siguiente se recupera Storyboard un de los recursos y, a Storyboard continuación, se ejecuta cuando se controla la clase de un evento interno.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

Comentarios

Los escenarios de animación más habituales no usan este método.Most typical animation scenarios do not use this method. Normalmente, se crea el Storyboard elemento BeginStoryboard o en el marcado y, a continuación, se colocan como el EventTrigger contenido en un elemento.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Cuando lo desencadena el evento, se ejecuta la animación.When triggered by the event, the animation then runs. La mayoría de los aspectos de control Storyboard de un se pueden resolver mediante propiedades que se exponen en el marcado.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

En el caso de las firmas que no usan isControllableel parámetro, o cuando se especifica falseese parámetro, los relojes de la escala de tiempo que están asociados a la animación se quitan tan pronto como la animación alcanza el período de "relleno".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. Por lo tanto, la animación no se puede reiniciar después de ejecutarse una vez.Therefore the animation cannot be restarted after running once. Controlar una animación también requiere que el guion gráfico tenga una Directiva x:Name o que sea accesible por referencia en el código.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)

Comienza la secuencia de acciones contenidas en el guión gráfico proporcionado, con opciones especificadas para lo que debería ocurrir si la propiedad ya está animada.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

Parámetros

storyboard
Storyboard Storyboard Storyboard

Guión gráfico que se va a iniciar.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Valor de la enumeración que describe el comportamiento que se va a usar si ya está animada una propiedad descrita en el guión gráfico.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Ejemplos

En el ejemplo siguiente se recupera Storyboard un de los recursos y, a Storyboard continuación, se ejecuta cuando se controla la clase de un evento interno.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

Comentarios

Los escenarios de animación más habituales no usan este método.Most typical animation scenarios do not use this method. Normalmente, se crea el Storyboard elemento BeginStoryboard o en el marcado y, a continuación, se colocan como el EventTrigger contenido en un elemento.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Cuando lo desencadena el evento, se ejecuta la animación.When triggered by the event, the animation then runs. La mayoría de los aspectos de control Storyboard de un se pueden resolver mediante propiedades que se exponen en el marcado.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

En el caso de las firmas que no usan isControllableel parámetro, o cuando se especifica falseese parámetro, los relojes de la escala de tiempo que están asociados a la animación se quitan tan pronto como la animación alcanza el período de "relleno".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. Por lo tanto, la animación no se puede reiniciar después de ejecutarse una vez.Therefore the animation cannot be restarted after running once. Controlar una animación también requiere que el guion gráfico tenga una Directiva x:Name o que sea accesible por referencia en el código.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

El comportamiento de la entrega se puede especificar como BeginStoryboardun atributo de.Handoff behavior can be specified as an attribute of BeginStoryboard.

Usar el HandoffBehavior ComposeUsing the Compose HandoffBehavior

Cuando se aplica un Storyboard, AnimationTimelineo AnimationClock a una propiedad mediante el Compose HandoffBehavior, todos Clock los objetos asociados previamente a esa propiedad continúan consumiendo recursos del sistema; el sistema de control de tiempo no se quitan automáticamente los relojes.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.

Para evitar problemas de rendimiento al aplicar un gran número de relojes mediante el uso Composede, debe quitar los relojes de composición de la propiedad animada una vez completados.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. Hay varias maneras de quitar un reloj:There are several ways to remove a clock:

Este problema se produce principalmente en las animaciones de objetos que tienen un período de duración prolongado.This is primarily an issue for animations on objects that have a long lifetime. Cuando un objeto se recolecta como elemento no utilizado, sus relojes también se desconectan y se recolectan los elementos no utilizados.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Para obtener más información sobre los objetos de reloj, consulte información general sobre sistemas de control de tiempo y animación.For more information about clock objects, see Animation and Timing System Overview.

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

Comienza la secuencia de acciones contenidas en el guión gráfico proporcionado, con el estado especificado para el control de la animación una vez iniciado.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

Parámetros

storyboard
Storyboard Storyboard Storyboard

Guión gráfico que se va a iniciar.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Valor de la enumeración que describe el comportamiento que se va a usar si ya está animada una propiedad descrita en el guión gráfico.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean Boolean Boolean

Declara si la animación se puede controlar (se puede pausar) después de que se ha iniciado.Declares whether the animation is controllable (can be paused) after it is started.

Comentarios

Los escenarios de animación más habituales no usan este método.Most typical animation scenarios do not use this method. Normalmente, se crea el Storyboard elemento BeginStoryboard o en el marcado y, a continuación, se colocan como el EventTrigger contenido en un elemento.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Cuando lo desencadena el evento, se ejecuta la animación.When triggered by the event, the animation then runs. La mayoría de los aspectos de control Storyboard de un se pueden resolver mediante propiedades que se exponen en el marcado.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

En el caso de las firmas que no usan isControllableel parámetro, o cuando se especifica falseese parámetro, los relojes de la escala de tiempo que están asociados a la animación se quitan tan pronto como la animación alcanza el período de "relleno".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. Por lo tanto, la animación no se puede reiniciar después de ejecutarse una vez.Therefore the animation cannot be restarted after running once. Controlar una animación también requiere que el guion gráfico tenga una Directiva x:Name o que sea accesible por referencia en el código.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

El comportamiento de la entrega se puede especificar como BeginStoryboardun atributo de.Handoff behavior can be specified as an attribute of BeginStoryboard.

Usar el HandoffBehavior ComposeUsing the Compose HandoffBehavior

Cuando se aplica un Storyboard, AnimationTimelineo AnimationClock a una propiedad mediante el Compose HandoffBehavior, todos Clock los objetos asociados previamente a esa propiedad continúan consumiendo recursos del sistema; el sistema de control de tiempo no se quitan automáticamente los relojes.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.

Para evitar problemas de rendimiento al aplicar un gran número de relojes mediante el uso Composede, debe quitar los relojes de composición de la propiedad animada una vez completados.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. Hay varias maneras de quitar un reloj:There are several ways to remove a clock:

Este problema se produce principalmente en las animaciones de objetos que tienen un período de duración prolongado.This is primarily an issue for animations on objects that have a long lifetime. Cuando un objeto se recolecta como elemento no utilizado, sus relojes también se desconectan y se recolectan los elementos no utilizados.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Para obtener más información sobre los objetos de reloj, consulte información general sobre sistemas de control de tiempo y animación.For more information about clock objects, see Animation and Timing System Overview.

Se aplica a