EventTrigger Classe

Definição

Namespace:

Windows.UI.Xaml

Representa um gatilho que aplica um conjunto de ações (storyboards de animação) em resposta a um evento. Não usado com frequência. Consulte Observações.

public ref class EventTrigger sealed : TriggerBase

/// [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="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase

[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="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

<EventTrigger>
  oneOrMoreBeginStoryboards
</EventTrigger>
 

Herança

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

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 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, faça um destes:

• Use animações internas da biblioteca de animação. Confira Início Rápido: Animando sua interface do usuário usando a biblioteca de animação.
• Para eventos em modelos de controle, use estados visuais e VisualStateManager. Confira Animações storyboarded para estados visuais ou Início Rápido: Modelos de controle.
• Para animações de interface do usuário específicas do aplicativo, defina um manipulador Carregado na página. Esse manipulador pode referenciar um Storyboard definido em recursos de nível de página e chamar o método Begin nesse Storyboard. Confira Animações com storyboard.

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, não defina o atributo RoutedEvent . Basta usar o XAML <EventTrigger>. Se você definir RoutedEvent explicitamente (não recomendado), o único XAML que funciona será <EventTrigger RoutedEvent="FrameworkElement.Loaded">. "Loaded" não qualificado ou qualquer outro valor gera uma exceção de análise. Para obter mais informações, consulte Gatilhos.

Construtores

EventTrigger()

Inicializa uma nova instância da classe EventTrigger .

Propriedades

Actions	Obtém a coleção de objetos BeginStoryboard que este EventTrigger mantém.
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar 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)
RoutedEvent	Obtém ou define o nome do evento que inicia o gatilho. Não definido normalmente, consulte Comentários.

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

• TriggerBase
• Triggers
• Animações de storyboard para estados visuais
• Início rápido: modelos de controle