RemoveStoryboard Classe

Definizione

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

Ereditarietà

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Esempio

Nell'esempio seguente viene illustrato come rimuovere un Storyboard oggetto per impedirlo di continuare quando l'utente passa dalla pagina contenente l'oggetto 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>

Commenti

Usare RemoveStoryboard con un EventTrigger oggetto o Trigger per rimuovere un Storyboardoggetto .

Sospendere, riprendere, arrestare, rimuovere o controllare in modo interattivo un storyboard

Per poter sospendere, riprendere, rimuovere o controllare in modo interattivo un Storyboard controllo interattivo, impostare la Name proprietà del relativo BeginStoryboard oggetto e usare un ControllableStoryboardAction oggetto (ad esempio PauseStoryboardResumeStoryboard, o StopStoryboard) per controllarlo facendo riferimento alla relativa Nameproprietà . Se l'oggetto di BeginStoryboard non è specificato, non Storyboard può essere controllato in modo interattivo dopo l'avvioName. Per altre informazioni , vedere Procedura: Usare trigger eventi per controllare uno storyboard dopo l'avvio .

Quando rimuovere storyboard

È consigliabile usare l'azione RemoveStoryboard per rimuovere eventuali storyboard iniziati con un HandoffBehavior oggetto .Compose È anche consigliabile rimuovere animazioni in background quando l'oggetto animato non viene più usato. Ad esempio, se si applica un storyboard indefinito usando l'evento di Loaded un elemento, è necessario creare anche un'azione EventTrigger che usa un'azione RemoveStoryboard per rimuovere lo storyboard nell'evento dell'elemento Unloaded .

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• EventTrigger