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 seguinte mostra como remover a Storyboard para impedir que continue quando o utilizador se afasta 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>

Observações

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

Pausar, Retomar, Parar, Remover ou Controlar um Storyboard de forma interativa

Para poder pausar, retomar, remover ou de outra forma controlar um Storyboard de forma interativa, defina a Name propriedade de e BeginStoryboard use um ControllableStoryboardAction objeto (como PauseStoryboard, ResumeStoryboard, ou StopStoryboard) para o controlar, referenciando o seu Name. Se o Name de BeginStoryboard não for especificado, não Storyboard pode ser controlado interativamente após o seu início. Veja como: Use os gatilhos de eventos para controlar um storyboard após o início para mais informações.

Quando Remover Storyboards

Deves usar a RemoveStoryboard ação para remover quaisquer storyboards iniciados com um HandoffBehavior de Compose. Também é boa ideia remover animações de fundo quando o objeto que animam deixa de ser usado. Por exemplo, se aplicares um storyboard repetitivo indefinidamente usando o evento de Loaded um elemento, deves também criar um EventTrigger que use uma RemoveStoryboard ação para remover o storyboard do evento do Unloaded elemento.

Ver também

• EventTrigger