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

Das folgende Beispiel zeigt, wie Sie eine Entfernen entfernen Storyboard , um zu verhindern, dass sie fortgesetzt wird, wenn der Benutzer von der Seite mit der StoryboardSeite navigiert.

<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

Wird RemoveStoryboard mit einem EventTrigger oder Trigger zum Entfernen eines Storyboard.

Anhalten, Fortsetzen, Beenden, Entfernen oder anderweitiges Steuern eines Storyboards interaktiv

Um eine Storyboard interaktive Eigenschaft anhalten, fortsetzen, entfernen oder anderweitig steuern zu können, legen Sie die Name Eigenschaft des Objekts BeginStoryboard fest und verwenden ein ControllableStoryboardAction Objekt (z PauseStoryboard. B. , ResumeStoryboardoder StopStoryboard), um es zu steuern, indem Sie darauf verweisen Name. Wenn dies NameBeginStoryboard nicht angegeben ist, kann dies Storyboard nach dem Starten nicht interaktiv gesteuert werden. Weitere Informationen finden Sie unter How to: Use Event Triggers to Control a Storyboard After It Starts for more information.

Gründe für das Entfernen von Storyboards

Sie sollten die RemoveStoryboard Aktion verwenden, um alle Storyboards zu entfernen, die mit einem HandoffBehavior von Compose. Außerdem empfiehlt es sich, Hintergrundanimationen zu entfernen, wenn das objekt, das sie animieren, nicht mehr verwendet wird. Wenn Sie z. B. ein auf unbestimmte Zeit wiederholtes Storyboard mithilfe des Ereignisses Loaded eines Elements anwenden, sollten Sie auch eine RemoveStoryboardEventTrigger Aktion erstellen, um das Storyboard für das Ereignis des Unloaded Elements zu entfernen.

Weitere Informationen

• EventTrigger