RemoveStoryboard Classe

Definição

public ref class RemoveStoryboard sealed : System::Windows::Media::Animation::ControllableStoryboardAction

public sealed class RemoveStoryboard : System.Windows.Media.Animation.ControllableStoryboardAction

type RemoveStoryboard = class
    inherit ControllableStoryboardAction

Public NotInheritable Class RemoveStoryboard
Inherits ControllableStoryboardAction

Herança

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Exemplos

O exemplo a seguir mostra como remover um Storyboard para impedi-lo de continuar quando o usuário navega para longe da página que contém o Storyboard.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  Name="RootPage">
  <StackPanel>

    <!-- The MediaElement control plays the sound. -->
    <MediaElement Name="myMediaElement" />

    <Button Name="BeginButton">Begin</Button>

    <StackPanel.Triggers>

      <!-- This trigger causes the Storyboard to start (the music start) when you click the
           "BeginButton" button. -->
      <EventTrigger RoutedEvent="Button.Click" SourceName="BeginButton">
        <EventTrigger.Actions>
          <BeginStoryboard Name="myBeginStoryboard">
            <Storyboard>
              <MediaTimeline Source="C:\WINDOWS\Media\town.mid" Storyboard.TargetName="myMediaElement"  
               RepeatBehavior="Forever" />
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger.Actions>
      </EventTrigger>

      <!-- When this page unloads, like when you navigate away from the page, this
           trigger causes the Storyboard to be removed and the clock to stop. If 
           you come back to this page and click the button to start the Storyboard,
           the music starts from the beginning. Alternatively, if you don't unload 
           the Storyboard when you leave the page, the Storyboard does not stop while 
           you're gone and when you navigate back to the page you hear the music  
           continuing as though you had never left. -->
      <EventTrigger RoutedEvent="Page.Unloaded" >
        <EventTrigger.Actions>
          <RemoveStoryboard BeginStoryboardName="myBeginStoryboard" />
        </EventTrigger.Actions>
      </EventTrigger>
    </StackPanel.Triggers>
  </StackPanel>
</Page>

Comentários

Use RemoveStoryboard com um EventTrigger ou Trigger para remover um Storyboard.

Pausar, retomar, parar, remover ou controlar um storyboard interativamente

Para poder pausar, retomar, remover ou controlar um Storyboard interativamente, defina a Name propriedade dele BeginStoryboard e use um ControllableStoryboardAction objeto (como PauseStoryboard, ResumeStoryboardou StopStoryboard) para controlá-lo referenciando seu Name. Se o Name de BeginStoryboard não for especificado, o Storyboard não poderá ser controlado interativamente depois de iniciado. Consulte Como usar gatilhos de evento para controlar um storyboard após o início para obter mais informações.

Quando remover storyboards

Você deve usar a ação para remover todos os RemoveStoryboard storyboards iniciados com um HandoffBehavior de Compose. Também é uma boa ideia remover animações em segundo plano quando o objeto que eles animam não está mais sendo usado. Por exemplo, se você aplicar um storyboard repetido indefinidamente usando o evento de Loaded um elemento, também deverá criar um EventTrigger que use uma RemoveStoryboard ação para remover o storyboard no evento do Unloaded elemento.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• EventTrigger