RemoveStoryboard Klass

Definition

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

Arv

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Exempel

I följande exempel visas hur du tar bort en Storyboard för att hindra den från att fortsätta när användaren navigerar bort från sidan som innehåller 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>

Kommentarer

Använd RemoveStoryboard med en EventTrigger eller Trigger för att ta bort en Storyboard.

Pausa, återuppta, stoppa, ta bort eller på annat sätt styra en storyboard interaktivt

Om du vill kunna pausa, återuppta, ta bort eller på annat sätt kontrollera en Storyboard interaktivt anger du Name egenskapen för dess BeginStoryboard och använder ett ControllableStoryboardAction objekt (till exempel PauseStoryboard, ResumeStoryboardeller StopStoryboard) för att kontrollera det genom att referera till dess Name. Om av NameBeginStoryboard är ospecificerad kan Storyboard inte kontrolleras interaktivt efter att den har påbörjats. Mer information finns i How to: Use Event Triggers to Control a Storyboard After It Starts (Så här gör du: Använda händelseutlösare för att styra en storyboard när den startar ).

När du ska ta bort storyboards

Du bör använda åtgärden RemoveStoryboard för att ta bort alla storyboards som påbörjats med en HandoffBehavior av Compose. Det är också en bra idé att ta bort bakgrundsanimationer när objektet de animerar inte längre används. Om du till exempel använder en upprepande storyboard på obestämd tid med hjälp av ett elements Loaded händelse bör du också skapa en EventTrigger som använder en RemoveStoryboard åtgärd för att ta bort storyboarden i elementets Unloaded händelse.

Se även

• EventTrigger