FrameworkContentElement.BeginStoryboard Método

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)

Parâmetros

Observações

Para as assinaturas que não utilizam o isControllableparâmetro , ou quando esse parâmetro é especificado false, os relógios de linha temporal associados à animação são removidos assim que atinge o período de "Preenchimento". Portanto, a animação não pode ser reiniciada depois de ter sido executada uma vez. Note que controlar uma animação também exige que o storyboard seja nomeado ou acessível como uma instância em código.

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)

Parâmetros

Observações

Para as assinaturas que não utilizam o isControllableparâmetro , ou quando esse parâmetro é especificado false, os relógios de linha temporal associados à animação são removidos assim que atinge o período de "Preenchimento". Portanto, a animação não pode ser reiniciada depois de ter sido executada uma vez. Note que controlar uma animação também exige que o storyboard seja nomeado ou acessível como uma instância em código.

Usando o Compose HandoffBehavior

Quando aplica um Storyboard, , ou AnimationClock a uma propriedade usando ,HandoffBehaviorCompose quaisquer Clock objetos anteriormente associados a essa propriedade continuam a consumir recursos do sistema; o sistema de temporização não remove automaticamente AnimationTimelineos relógios.

Para evitar problemas de desempenho ao aplicar um grande número de relógios usando Compose, deve remover os relógios de composição da propriedade animada depois de terminarem. Existem várias formas de remover um relógio:

• Para remover todos os relógios de uma propriedade, use o método ApplyAnimationClock(DependencyProperty, AnimationClock) ou BeginAnimation(DependencyProperty, AnimationTimeline) do objeto animado. Especifique a propriedade que está sendo animada como o primeiro parâmetro e null como o segundo. Isto remove todos os relógios de animação da propriedade.

• Para remover um específico AnimationClock de uma lista de relógios, use a Controller propriedade do AnimationClock para recuperar um ClockControllere, em seguida, chame o Remove método do ClockController. Isso geralmente é feito no manipulador de eventos de um Completed relógio. Note que apenas os relógios raiz podem ser controlados por um ClockController; a Controller propriedade de um relógio filho devolve null. Note também que o Completed evento não é elevado se a duração efetiva do relógio for para sempre. Nesse caso, o utilizador deve determinar quando chamar Remove.

Isso é principalmente um problema para animações em objetos que têm uma longa vida útil. Quando um objeto é recolhido com lixo, os seus relógios também são desligados e recolhidos pelo lixo.

Para obter mais informações sobre objetos de relógio, consulte Visão geral do sistema de animação e cronometragem.

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)

Parâmetros

Observações

Para as assinaturas que não utilizam o isControllableparâmetro , ou quando esse parâmetro é especificado false, os relógios de linha temporal associados à animação são removidos assim que atinge o período de "Preenchimento". Portanto, a animação não pode ser reiniciada depois de ter sido executada uma vez. Note que controlar uma animação também exige que o storyboard seja nomeado ou acessível como uma instância em código.

Usando o Compose HandoffBehavior

Quando se aplica um Storyboard, , ou AnimationClock a uma propriedade usando ,HandoffBehaviorCompose quaisquer Clock objetos anteriormente associados a essa propriedade continuam a consumir recursos do sistema; o sistema de temporização não remove automaticamente AnimationTimelineestes relógios.

Para evitar problemas de desempenho ao aplicar um grande número de relógios usando Compose, deve remover os relógios de composição da propriedade animada depois de terminarem. Existem várias formas de remover um relógio:

• Para remover todos os relógios de uma propriedade, use o método ApplyAnimationClock(DependencyProperty, AnimationClock) ou BeginAnimation(DependencyProperty, AnimationTimeline) do objeto animado. Especifique a propriedade que está sendo animada como o primeiro parâmetro e null como o segundo. Isto remove todos os relógios de animação da propriedade.

• Para remover um específico AnimationClock de uma lista de relógios, use a Controller propriedade do AnimationClock para recuperar um ClockControllere, em seguida, chame o Remove método do ClockController. Isso geralmente é feito no manipulador de eventos de um Completed relógio. Note que apenas os relógios raiz podem ser controlados por um ClockController; a Controller propriedade de um relógio filho devolve null. Note também que o Completed evento não é elevado se a duração efetiva do relógio for para sempre. Nesse caso, o utilizador deve determinar quando chamar Remove.

Isso é principalmente um problema para animações em objetos que têm uma longa vida útil. Quando um objeto é recolhido com lixo, os seus relógios também são desligados e recolhidos pelo lixo.

Para obter mais informações sobre objetos de relógio, consulte Visão geral do sistema de animação e cronometragem.