Cómo: Controlar un guión gráfico una vez iniciado
Actualización: noviembre 2007
En este ejemplo se muestra cómo utilizar el código para controlar un objeto Storyboard después de iniciarse. Para controlar un guión gráfico en XAML, utilice los objetos Trigger y TriggerAction; para obtener un ejemplo, vea Cómo: Utilizar desencadenadores de eventos para controlar un guión gráfico después de su inicio.
Para iniciar un guión gráfico, se utiliza su método Begin, que distribuye las animaciones del guión gráfico a las propiedades animadas por ellas, e inicia el guión gráfico.
Para poder controlar un guión gráfico, se utiliza el método Begin y se especifica true como segundo parámetro. A continuación, puede utilizar los métodos interactivos del guión gráfico para pausar, reanudar, buscar, detener, acelerar o ralentizar el guión gráfico, o avanzarlo hasta su período del relleno. A continuación, se muestra una lista de los métodos interactivos del guión gráfico:
Pause: pone en pausa el guión gráfico.
Resume: reanuda un guión gráfico que se ha puesto en pausa.
SetSpeedRatio: establece la velocidad interactiva del guión gráfico.
Seek: busca en el guión gráfico la ubicación especificada.
SeekAlignedToLastTick: busca en el guión gráfico hasta la ubicación especificada. A diferencia del método Seek, esta operación se procesa antes del paso siguiente.
SkipToFill: avanza un guión gráfico hasta su período de relleno, si lo tiene.
Stop: detiene el guión gráfico.
En el ejemplo siguiente, se utilizan varios métodos de guión gráfico para controlar interactivamente un guión gráfico.
Nota: para ver un ejemplo de control de un guión gráfico mediante desencadenadores con XAML, vea Cómo: Utilizar desencadenadores de eventos para controlar un guión gráfico después de su inicio.
/* This example shows how to control a storyboard after it has started. */ using System; using System.Windows; using System.Windows.Controls; using System.Windows.Media; using System.Windows.Shapes; using System.Windows.Media.Animation; namespace Microsoft.Samples.Animation.TimingBehaviors { public partial class ControlStoryboardExample : Page { private Storyboard myStoryboard; public ControlStoryboardExample() { // Create a name scope for the page. NameScope.SetNameScope(this, new NameScope()); this.WindowTitle = "Controlling a Storyboard"; this.Background = Brushes.White; StackPanel myStackPanel = new StackPanel(); myStackPanel.Margin = new Thickness(20); // Create a rectangle. Rectangle myRectangle = new Rectangle(); myRectangle.Width = 100; myRectangle.Height = 20; myRectangle.Margin = new Thickness(12,0,0,5); myRectangle.Fill = new SolidColorBrush(Color.FromArgb(170, 51, 51, 255)); myRectangle.HorizontalAlignment = HorizontalAlignment.Left; myStackPanel.Children.Add(myRectangle); // Assign the rectangle a name by // registering it with the page, so that // it can be targeted by storyboard // animations. this.RegisterName("myRectangle", myRectangle); // // Create an animation and a storyboard to animate the // rectangle. // DoubleAnimation myDoubleAnimation = new DoubleAnimation(100, 500, new Duration(TimeSpan.FromSeconds(5))); Storyboard.SetTargetName(myDoubleAnimation, "myRectangle"); Storyboard.SetTargetProperty(myDoubleAnimation, new PropertyPath(Rectangle.WidthProperty)); myStoryboard = new Storyboard(); myStoryboard.Children.Add(myDoubleAnimation); // // Create some buttons to control the storyboard // and a panel to contain them. // StackPanel buttonPanel = new StackPanel(); buttonPanel.Orientation = Orientation.Horizontal; Button beginButton = new Button(); beginButton.Content = "Begin"; beginButton.Click += new RoutedEventHandler(beginButton_Clicked); buttonPanel.Children.Add(beginButton); Button pauseButton = new Button(); pauseButton.Content = "Pause"; pauseButton.Click +=new RoutedEventHandler(pauseButton_Clicked); buttonPanel.Children.Add(pauseButton); Button resumeButton = new Button(); resumeButton.Content = "Resume"; resumeButton.Click +=new RoutedEventHandler(resumeButton_Clicked); buttonPanel.Children.Add(resumeButton); Button skipToFillButton = new Button(); skipToFillButton.Content = "Skip to Fill"; skipToFillButton.Click +=new RoutedEventHandler(skipToFillButton_Clicked); buttonPanel.Children.Add(skipToFillButton); Button setSpeedRatioButton = new Button(); setSpeedRatioButton.Content = "Triple Speed"; setSpeedRatioButton.Click +=new RoutedEventHandler(setSpeedRatioButton_Clicked); buttonPanel.Children.Add(setSpeedRatioButton); Button stopButton = new Button(); stopButton.Content = "Stop"; stopButton.Click +=new RoutedEventHandler(stopButton_Clicked); buttonPanel.Children.Add(stopButton); myStackPanel.Children.Add(buttonPanel); this.Content = myStackPanel; } // Begins the storyboard. private void beginButton_Clicked(object sender, RoutedEventArgs args) { // Specifying "true" as the second Begin parameter // makes this storyboard controllable. myStoryboard.Begin(this, true); } // Pauses the storyboard. private void pauseButton_Clicked(object sender, RoutedEventArgs args) { myStoryboard.Pause(this); } // Resumes the storyboard. private void resumeButton_Clicked(object sender, RoutedEventArgs args) { myStoryboard.Resume(this); } // Advances the storyboard to its fill period. private void skipToFillButton_Clicked(object sender, RoutedEventArgs args) { myStoryboard.SkipToFill(this); } // Updates the storyboard's speed. private void setSpeedRatioButton_Clicked(object sender, RoutedEventArgs args) { // Makes the storyboard progress three times as fast as normal. myStoryboard.SetSpeedRatio(this, 3); } // Stops the storyboard. private void stopButton_Clicked(object sender, RoutedEventArgs args) { myStoryboard.Stop(this); } } }
