RemoveStoryboard Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media.Animation

Zestaw:

PresentationFramework.dll

Akcja wyzwalacza, która usuwa element 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

Dziedziczenie

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Przykłady

W poniższym przykładzie pokazano, jak usunąć obiekt , Storyboard aby zatrzymać jego kontynuowanie, gdy użytkownik przechodzi z dala od strony zawierającej Storyboardelement .

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

Uwagi

Użyj polecenia RemoveStoryboard z elementem EventTrigger lub Trigger , aby usunąć element Storyboard.

Wstrzymywanie, wznawianie, zatrzymywanie, usuwanie lub w inny sposób kontrolowanie scenorysu interaktywnie

Aby móc wstrzymywać, wznawiać, usuwać lub w inny sposób kontrolować Storyboard element interakcyjny, ustaw Name jego właściwość BeginStoryboard i użyj ControllableStoryboardAction obiektu (takiego jak PauseStoryboard, ResumeStoryboardlub StopStoryboard), aby kontrolować go, odwołując się do niego Name. Jeśli element jest NameBeginStoryboard nieokreślony, Storyboard nie można go interaktywnie kontrolować po rozpoczęciu. Zobacz Instrukcje: używanie wyzwalaczy zdarzeń do kontrolowania scenorysu po uruchomieniu , aby uzyskać więcej informacji.

Kiedy usunąć scenorysy

Należy użyć RemoveStoryboard akcji , aby usunąć wszystkie scenorysy rozpoczęte za pomocą elementu HandoffBehaviorCompose. Dobrym pomysłem jest również usunięcie animacji tła, gdy obiekt, który animuje, nie jest już używany. Na przykład w przypadku zastosowania scenorysu powtarzanego przez czas nieokreślony przy użyciu zdarzenia elementu Loaded należy również utworzyć EventTrigger obiekt, który używa RemoveStoryboard akcji w celu usunięcia scenorysu na zdarzeniu elementu Unloaded .

Konstruktory

RemoveStoryboard()

Inicjuje nowe wystąpienie klasy RemoveStoryboard.

Właściwości

BeginStoryboardName	Pobiera lub ustawia element NameBeginStoryboard , który zaczął Storyboard kontrolować interaktywnie. (Odziedziczone po ControllableStoryboardAction)
DependencyObjectType	Pobiera klasę DependencyObjectType , która opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera element, z Dispatcher który DispatcherObject jest skojarzony. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObjectpliku . (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości dla tego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia klasy DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy zostanie zaktualizowana efektywna wartość dowolnej właściwości DependencyObject zależności. Określona właściwość zależności, która została zmieniona, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania jej źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określonej przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Zobacz też

• EventTrigger