RemoveStoryboard Klasse

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

Vererbung

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie entfernt Storyboard werden, um zu verhindern, dass es fortgesetzt wird, wenn der Benutzer von der Seite weg navigiert, die den Storyboardenthält.

<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>

Hinweise

Verwenden Sie RemoveStoryboard mit einem EventTrigger oder Trigger , um einen Storyboardzu entfernen.

Anhalten, Fortsetzen, Beenden, Entfernen oder anderweitig interaktive Steuerung eines Storyboards

Um einen Storyboard interaktiv anhalten, fortsetzen, entfernen oder anderweitig steuern zu können, legen Sie die Name Eigenschaft der BeginStoryboard -Eigenschaft fest, und verwenden Sie ein ControllableStoryboardAction -Objekt (z PauseStoryboard. B. , ResumeStoryboardoder StopStoryboard), um es zu steuern, indem Sie auf dessen Nameverweisen. Wenn das Name von BeginStoryboard nicht angegeben ist, kann das Storyboard nicht interaktiv gesteuert werden, nachdem es begonnen wurde. Weitere Informationen finden Sie unter Vorgehensweise: Verwenden von Ereignistriggern zum Steuern eines Storyboards nach dem Start .

Wann Storyboards entfernt werden sollen

Sie sollten die RemoveStoryboard Aktion verwenden, um alle Storyboards zu entfernen, die mit einem HandoffBehavior von Composebegonnen wurden. Es empfiehlt sich auch, Hintergrundanimationen zu entfernen, wenn das objekt, das sie animieren, nicht mehr verwendet wird. Wenn Sie beispielsweise ein Storyboard anwenden, das sich unbegrenzt wiederholt, indem Sie das Ereignis eines Elements Loaded verwenden, sollten Sie auch ein EventTrigger erstellen, das eine RemoveStoryboard Aktion verwendet, um das Storyboard für das Ereignis des Unloaded Elements zu entfernen.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• EventTrigger