RemoveStoryboard Classe

Définition

Espace de noms:

System.Windows.Media.Animation

Assembly:

PresentationFramework.dll

Action de déclencheur qui supprime une table Storyboard.

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

Héritage

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Exemples

L’exemple suivant montre comment supprimer un Storyboard pour l’empêcher de continuer lorsque l’utilisateur quitte la page contenant .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>

Remarques

Utilisez RemoveStoryboard avec ou EventTriggerTrigger pour supprimer un Storyboard.

Suspendre, reprendre, arrêter, supprimer ou contrôler un storyboard de manière interactive

Pour pouvoir suspendre, reprendre, supprimer ou contrôler un Storyboard de manière interactive, définissez la Name propriété de son BeginStoryboard et utilisez un ControllableStoryboardAction objet (tel que PauseStoryboard, ResumeStoryboardou StopStoryboard) pour le contrôler en référençant son Name. Si le Name de BeginStoryboard n’est pas spécifié, le Storyboard ne peut pas être contrôlé de manière interactive une fois qu’il a commencé. Pour plus d’informations, consultez Guide pratique pour utiliser des déclencheurs d’événements pour contrôler un storyboard après son démarrage .

Quand supprimer des storyboards

Vous devez utiliser l’action RemoveStoryboard pour supprimer tous les storyboards commencés par un HandoffBehavior de Compose. Il est également recommandé de supprimer les animations d’arrière-plan lorsque l’objet qu’elles animent n’est plus utilisé. Par exemple, si vous appliquez un storyboard à répétition indéfinie à l’aide de l’événement Loaded d’un élément, vous devez également créer un EventTrigger qui utilise une RemoveStoryboard action pour supprimer le storyboard sur l’événement de Unloaded l’élément.

Constructeurs

RemoveStoryboard()

Initialise une nouvelle instance de la classe RemoveStoryboard.

Propriétés

BeginStoryboardName	Obtient ou définit le Name du BeginStoryboard qui a commencé le Storyboard que vous voulez contrôler de façon interactive. (Hérité de ControllableStoryboardAction)
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Voir aussi

• EventTrigger