RemoveStoryboard Класс

Определение

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

Наследование

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

Примеры

В следующем примере показано, как удалить его Storyboard , чтобы остановить его, когда пользователь переходит с страницы, содержащей объект 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>

Комментарии

Используйте RemoveStoryboard для EventTriggerTrigger удаления или Storyboardудаления .

Приостановка, возобновление, остановка, удаление или управление раскадровкой в интерактивном режиме

Чтобы иметь возможность приостановить, возобновить, удалить или иным образом управлять Storyboard интерактивным образом, задайте Name свойство его BeginStoryboard и используйте ControllableStoryboardAction объект (напримерPauseStoryboardResumeStoryboard, илиStopStoryboard) для управления им, ссылаясь на негоName. Если значение NameBeginStoryboard не указано, Storyboard его нельзя контролировать в интерактивном режиме после начала. См . инструкции. Использование триггеров событий для управления раскадровкой после начала работы с дополнительными сведениями.

Когда удалить раскадровки

Действие следует использовать RemoveStoryboard для удаления раскадровки, начинающегося с .ComposeHandoffBehavior Кроме того, рекомендуется удалить фоновые анимации, когда объект, который они анимируют, больше не используется. Например, если вы применяете бесконечно повторяющийся раскадровки с помощью события элемента Loaded , необходимо также создать EventTrigger действие, которое использует RemoveStoryboard действие для удаления раскадровки на событии элемента Unloaded .

См. также раздел

• EventTrigger