RemoveStoryboard Clase

Definición

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

Herencia

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Ejemplos

En el ejemplo siguiente se muestra cómo quitar un objeto Storyboard para impedir que continúe cuando el usuario se aleja de la página que contiene .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>

Comentarios

Use RemoveStoryboard con EventTrigger o Trigger para quitar un .Storyboard

Pausar, reanudar, detener, quitar o controlar de forma interactiva un guión gráfico

Para poder pausar, reanudar, quitar o controlar de otro modo un objeto Storyboard de forma interactiva, establezca la Name propiedad de y BeginStoryboard use un ControllableStoryboardAction objeto (como PauseStoryboard, ResumeStoryboardo StopStoryboard) para controlarlo haciendo referencia a su Name. Si no se especifica el Name de BeginStoryboard , no Storyboard se puede controlar interactivamente después de comenzar. Consulte Cómo: Usar desencadenadores de eventos para controlar un guión gráfico después de que se inicie para obtener más información.

Cuándo quitar guiones gráficos

Debe usar la RemoveStoryboard acción para quitar todos los guiones gráficos que comienzan con un HandoffBehavior de Compose. También es una buena idea quitar animaciones de fondo cuando el objeto que animan ya no se está usando. Por ejemplo, si aplica un guión gráfico repetido indefinidamente mediante el evento de Loaded un elemento, también debe crear un EventTrigger que use una RemoveStoryboard acción para quitar el guión gráfico en el evento del Unloaded elemento.

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• EventTrigger