BeginStoryboard Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BeginStoryboard final : TriggerAction
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BeginStoryboard : TriggerAction
Public NotInheritable Class BeginStoryboard
Inherits TriggerAction
<BeginStoryboard ...>
singleStoryboard
</BeginStoryboard>
- Herencia
- Atributos
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. En este XAML se muestran los elementos contenedor EventTrigger y BeginStoryboard en una relación adecuada con cada uno 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 usa originalmente para Microsoft Silverlight. Para 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 busque una animación en recursos de nivel de página y, a continuación, llame a Begin en el guión gráfico principal de la animación. Para obtener más información, consulta Plantillas de control XAML 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 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
| Nombre | Description |
|---|---|
| BeginStoryboard() |
Inicializa una nueva instancia de la clase BeginStoryboard . |
Propiedades
| Nombre | Description |
|---|---|
| Dispatcher |
Siempre devuelve |
| DispatcherQueue |
Obtiene el objeto |
| Storyboard |
Obtiene o establece el guión gráfico que se inicia este BeginStoryboard . |
| StoryboardProperty |
Identifica la propiedad de dependencia BeginStoryboard.Storyboard . |
Métodos
| Nombre | Description |
|---|---|
| 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) |