RemoveStoryboard Klas

Definitie

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

Overname

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Voorbeelden

In het volgende voorbeeld ziet u hoe u een Storyboard bestand verwijdert om te voorkomen dat deze wordt voortgezet wanneer de gebruiker weg navigeert van de pagina met de 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>

Opmerkingen

Gebruiken RemoveStoryboard met een EventTrigger of Trigger om een Storyboard.

Interactief een storyboard onderbreken, hervatten, stoppen, verwijderen of anderszins beheren

Als u een Storyboard interactief object wilt onderbreken, hervatten, verwijderen of anderszins wilt beheren, stelt u de eigenschap van Name het BeginStoryboard object in en gebruikt u een ControllableStoryboardAction object (zoals PauseStoryboardResumeStoryboard, of StopStoryboard) om deze te beheren door te verwijzen naar de eigenschap Name. Als de Name waarde BeginStoryboard niet is opgegeven, kan deze Storyboard niet interactief worden beheerd nadat deze is gestart. Zie Procedure: Gebeurtenistriggers gebruiken om een Storyboard te beheren nadat deze is gestart voor meer informatie.

Wanneer storyboards verwijderen

U moet de RemoveStoryboard actie gebruiken om alle storyboards te verwijderen die zijn begonnen met een HandoffBehavior van Compose. Het is ook een goed idee om achtergrondanimaties te verwijderen wanneer het object dat ze animeren niet meer wordt gebruikt. Als u bijvoorbeeld voor onbepaalde tijd een herhalend storyboard toepast met behulp van de gebeurtenis van Loaded een element, moet u ook een EventTriggerRemoveStoryboard actie maken om het storyboard op de gebeurtenis van Unloaded het element te verwijderen.

Zie ook

• EventTrigger