BeginStoryboard Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Media.Animation

Acción de desencadenador que comienza un Guión gráfico. No se suele utilizar. Vea la sección Comentarios.

public ref class BeginStoryboard sealed : TriggerAction

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BeginStoryboard final : TriggerAction

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BeginStoryboard : TriggerAction

Public NotInheritable Class BeginStoryboard
Inherits TriggerAction

<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>

Herencia

Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo xaml se muestra la estructura básica para usar FrameworkElement.Triggers con su comportamiento de desencadenador frameworkElement.Loaded predeterminado para ejecutar una animación con guion gráfico. Este XAML muestra los elementos contenedor EventTrigger y BeginStoryboard en una relación adecuada con cada uno de ellos con su sintaxis de propiedad de contenido XAML y etiquetas de elemento de propiedad innecesarias (como BeginStoryboard.Storyboard) omitidas.

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

Comentarios

Los desencadenadores, EventTrigger, Actions y BeginStoryboard no se usan normalmente. Estas API existen principalmente para la compatibilidad en XAML que se usó originalmente para Microsoft Silverlight. En la mayoría de los escenarios en los que se usaron anteriormente desencadenadores de eventos, debe usar estados visuales o iniciar animaciones escribiendo un controlador cargado que busca una animación en recursos de nivel de página y, a continuación, llama a Begin en el guión gráfico principal de la animación. Para obtener más información, consulta Inicio rápido: Plantillas de control o animaciones con guion gráfico.

Si eliges usar desencadenadores, en Windows Runtime XAML, el comportamiento predeterminado de los desencadenadores de eventos y el único evento que se puede usar para invocar un EventTrigger es FrameworkElement.Loaded. Dado que es el comportamiento predeterminado y el único habilitado, no estableces RoutedEvent y solo usas el xaml <EventTrigger>. Para obtener más información, consulta Desencadenadores.

Constructores

BeginStoryboard()

Inicializa una nueva instancia de la clase BeginStoryboard .

Propiedades

Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
Storyboard	Obtiene o establece el Guión gráfico que se inicia este BeginStoryboard .
StoryboardProperty	Identifica la propiedad de dependencia BeginStoryboard.Storyboard .

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Consulte también

• TriggerAction
• Triggers
• Storyboard
• Inicio rápido: Plantillas de control