EventTrigger Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Representa um gatilho que aplica um conjunto de ações em resposta a um evento.

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 Rectanglecomo . 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 interfiram no comportamento inerente do 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 primeiro é manipulado 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 true como para que o evento seja gerado.

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

Construtores

EventTrigger()	Inicializa uma nova instância da classe EventTrigger.
EventTrigger(RoutedEvent)	Inicializa uma nova instância da classe EventTrigger com o evento especificado.

Propriedades

Actions	Obtém a coleção de ações a serem aplicadas durante o evento.
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
EnterActions	Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto gatilho se tornar ativo. Essa propriedade não se aplica à classe EventTrigger. (Herdado de TriggerBase)
ExitActions	Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto de gatilho se tornar inativo. Essa propriedade não se aplica à classe EventTrigger. (Herdado de TriggerBase)
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)
RoutedEvent	Obtém ou define o RoutedEvent que ativará esse gatilho.
SourceName	Obtém ou define o nome do objeto com o evento que ativa o gatilho. Isso é usado somente por disparadores de elemento ou de modelo.

Métodos

AddChild(Object)	Adiciona o objeto especificado à coleção Actions do gatilho de evento atual.
AddText(String)	Este método não é compatível e resulta em uma exceção.
CheckAccess()	Determina se o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeActions()	Indica se os processos de serialização devem serializar o valor efetivo da propriedade Actions em instâncias dessa classe.
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Implantações explícitas de interface

IAddChild.AddChild(Object)	Adiciona um objeto filho.
IAddChild.AddText(String)	Adiciona o conteúdo do texto de um nó ao objeto.

Confira também

• EventSetter