BeginStoryboard Classe

Definição

Namespace:

Microsoft.UI.Xaml.Media.Animation

Uma ação de gatilho que inicia um Storyboard. Não usado com frequência. Consulte Observações.

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>

Herança

Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard

Atributos

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Este exemplo XAML mostra a estrutura básica para usar FrameworkElement.Triggers com seu comportamento padrão de gatilho FrameworkElement.Loaded para executar uma animação com storyboard. Este XAML mostra os elementos de contêiner EventTrigger e BeginStoryboard em uma relação adequada com cada um usando sua sintaxe de propriedade de conteúdo XAML e marcas de elemento de propriedade desnecessárias (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>

Comentários

Gatilhos, EventTrigger, Actions e BeginStoryboard não são comumente usados. Essas API existem principalmente para compatibilidade no XAML originalmente usado para o Microsoft Silverlight. Para a maioria dos cenários em que os gatilhos de evento foram usados anteriormente, você deve usar estados visuais ou iniciar animações escrevendo um manipulador Loaded que pesquisa uma animação em recursos de nível de página e, em seguida, chama Begin no storyboard main da animação. Para obter mais informações, consulte Modelos de controle XAML ou animações storyboarded.

Se você optar por usar Gatilhos, em Windows Runtime XAML, o comportamento padrão para gatilhos de evento e o único evento que pode ser usado para invocar um EventTrigger será FrameworkElement.Loaded. Como esse é o padrão e o único comportamento habilitado, você não define RoutedEvent e apenas usa o XAML <EventTrigger>. Para obter mais informações, consulte Gatilhos.

Construtores

BeginStoryboard()

Inicializa uma nova instância da classe BeginStoryboard .

Propriedades

Dispatcher	Sempre retorna null em um aplicativo SDK do Aplicativo Windows. Em vez disso, use DispatcherQueue . (Herdado de DependencyObject)
DispatcherQueue	Obtém o ao DispatcherQueue qual esse objeto está associado. O DispatcherQueue representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
Storyboard	Obtém ou define o Storyboard que este BeginStoryboard inicia.
StoryboardProperty	Identifica a propriedade de dependência BeginStoryboard.Storyboard .

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Confira também

• TriggerAction
• Triggers
• Storyboard
• Modelos de controle XAML