EventTrigger Classe

Definição

public ref class EventTrigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Actions")]
public class EventTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Actions")>]
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild

Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild

Herança

Object

DispatcherObject

DependencyObject

TriggerBase

EventTrigger

Atributos

ContentPropertyAttribute

Implementações

IAddChild

Exemplos

Este exemplo mostra como usar gatilhos de evento em um estilo para animar os MouseEnter eventos e MouseLeave de um FrameworkElement. Neste exemplo, o Style tem o TargetType definido como Rectangle. Portanto, não é necessário qualificar os nomes de MouseEnter eventos e MouseLeave com o nome da classe.

<Style TargetType="Rectangle">
  <Setter Property="Width" Value="50" />
  <Setter Property="Height" Value="50" />
  <Setter Property="Margin" Value="20" />
  <Setter Property="HorizontalAlignment" Value="Left" />
  <Style.Triggers>
    <EventTrigger RoutedEvent="MouseEnter">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation To="300" Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
    <EventTrigger RoutedEvent="MouseLeave">
        <BeginStoryboard>
            <Storyboard>
              <DoubleAnimation Duration="0:0:1.5" 
                AccelerationRatio="0.10" DecelerationRatio="0.25" 
                Storyboard.TargetProperty="(Canvas.Width)" />
            </Storyboard>
        </BeginStoryboard>
    </EventTrigger>
  </Style.Triggers>
</Style>

Comentários

Trigger os objetos têm as Setterspropriedades , EnterActionse ExitActions que aplicam alterações ou ações com base no estado de determinadas propriedades, enquanto EventTrigger os objetos iniciam um conjunto de Actions quando ocorre um evento roteado especificado. Por exemplo, talvez você queira usar um EventTrigger para iniciar um conjunto de animações quando o ponteiro do mouse estiver sobre um determinado controle de interface do usuário. Ao contrário Triggerde , EventTrigger não tem nenhum conceito de encerramento de estado, portanto, a ação não será desfeita depois que a condição que gerou o evento não for mais verdadeira.

Observe que, ao usar um EventTrigger, você precisa escolher eventos que não interferem no comportamento inerente do seu controle. Controles como Button ou TextBox executam ações específicas em eventos de entrada do usuário, como cliques do mouse e eventos de teclado. Por exemplo, se você estiver estilizando um botão e tentar definir o MouseDown evento como o RoutedEvent de um EventTrigger, o EventTrigger nunca será aplicado porque o evento é manipulado primeiro pelo botão. Em vez disso, você pode usar o PreviewMouseDown evento ou um evento diferente.

Ao usar a associação de dados, se você estiver usando o TargetUpdated evento, deverá definir o NotifyOnTargetUpdated valor do Binding objeto como true para que o evento seja gerado.

Adicionar um TriggerAction filho a um EventTrigger objeto o adiciona implicitamente ao TriggerActionCollection para o EventTrigger objeto .

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• EventSetter
• Introdução ao exemplo de modelagem e estilo