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 eventos num estilo para animar os MouseEnter eventos e MouseLeave de um FrameworkElement. Neste exemplo, o Style tem o TargetType conjunto de Rectangle. Portanto, não é necessário qualificar os MouseEnter nomes dos MouseLeave eventos com o nome da turma.

<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>

Observações

Trigger Os objetos têm as Setterspropriedades , EnterActions, e ExitActions que aplicam alterações ou ações com base no estado de certas propriedades, enquanto EventTrigger os objetos iniciam um conjunto de Actions quando ocorre um evento encaminhado especificado. Por exemplo, pode querer usar an EventTrigger para iniciar um conjunto de animações quando o ponteiro do rato está sobre um determinado controlo de interface de utilizador (UI). Ao contrário de , Trigger não tem conceito de terminação de estado, pelo que a ação não será desfeita quando a condição que levantou EventTriggero evento deixa de ser verdadeira.

Note que, ao usar um EventTrigger, precisa de escolher eventos que não interfiram com o comportamento inerente do seu controlo. Controlos como Button ou TextBox realizam ações específicas em eventos de entrada do utilizador, como cliques de rato e eventos de teclado. Por exemplo, se estilizares um botão e tentares definir o MouseDown evento como o RoutedEvent de um EventTrigger, o EventTrigger evento nunca é aplicado porque o evento é tratado primeiro pelo botão. Em vez disso, pode usar o PreviewMouseDown evento ou um evento diferente.

Ao usar data binding, se estiver a usar o TargetUpdated evento, deve definir o NotifyOnTargetUpdated valor do seu Binding objeto para true que o evento seja elevado.

Adicionar um TriggerAction filho a um EventTrigger objeto implícitamente adiciona-o ao TriggerActionCollection para o EventTrigger objeto.

Ver também

• EventSetter