Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

FrameworkElement.BeginStoryboard (Método) (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.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

public void BeginStoryboard(
	Storyboard storyboard,
	HandoffBehavior handoffBehavior,
	bool isControllable
)

Parámetros

storyboard
Tipo: System.Windows.Media.Animation.Storyboard
Guión gráfico que se va a iniciar.
handoffBehavior
Tipo: System.Windows.Media.Animation.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.
isControllable
Tipo: System.Boolean
Declara si la animación se puede controlar (se puede pausar) después de que se ha iniciado.

La mayor parte de los escenarios de animación típicos no usan este método. Normalmente, el elemento de Storyboard o BeginStoryboard se crea en el marcado y, a continuación, se coloca como contenido de EventTrigger en un elemento. La animación se ejecuta cuando la desencadena el evento. La mayor parte de los aspectos del control de un objeto Storyboard los pueden tratar las propiedades expuestas en el marcado.

En las firmas que no usan el parámetro isControllable o cuando se especifica ese parámetro como false, se quitan los relojes de la escala de tiempo asociados con la animación en cuanto ésta llega al período de "Relleno". Por consiguiente, la animación no se puede reiniciar después de ejecutarse una vez. El control de una animación también requiere que el guión gráfico tenga un x:Name (Directiva) o que se pueda tener acceso a él mediante una referencia en el código.

El comportamiento de entrega se puede especificar como un atributo de BeginStoryboard.

Uso de la enumeración HandoffBehavior del campo Compose

Cuando aplica Storyboard, AnimationTimeline o AnimationClock a una propiedad mediante ComposeHandoffBehavior, los objetos Clock asociados con anterioridad a esa propiedad siguen utilizando recursos del sistema; el sistema de temporización no quita automáticamente los relojes.

Para evitar problemas de rendimiento cuando aplique muchos relojes mediante Compose, debe quitar los relojes de composición de la propiedad animada cuando se hayan completado. Hay varias formas de quitar un reloj:

Este problema se produce principalmente en las animaciones de objetos que tienen una duración prolongada. Cuando un objeto se recolecta como elemento no utilizado, sus relojes también se desconectan y se recolectan como elementos no utilizados.

Para obtener más información acerca de los objetos de reloj, vea Información general sobre sistemas de temporización y animación.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: