EventTrigger Classe

Definição

Representa um gatilho que aplica um conjunto de ações em resposta a um evento.Represents a trigger that applies a set of actions in response to an event.

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
Atributos
Implementações

Exemplos

Este exemplo mostra como usar gatilhos de evento em um estilo para animar os MouseEnter MouseLeave eventos e de um FrameworkElement .This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. Neste exemplo, o Style tem o TargetType definido como Rectangle .In this example, the Style has the TargetType set to Rectangle. Portanto, não há necessidade de qualificar os MouseEnter MouseLeave nomes do evento e com o nome da classe.Therefore, there is no need to qualify the MouseEnter and MouseLeave event names with the class name.

<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 Setters as EnterActions Propriedades, e ExitActions que aplicam alterações ou ações com base no estado de determinadas propriedades, enquanto os EventTrigger objetos iniciam um conjunto de Actions quando ocorre um evento roteado especificado.Trigger objects have the Setters, EnterActions, and ExitActions properties that apply changes or actions based on the state of certain properties, while EventTrigger objects start a set of Actions when a specified routed event occurs. Por exemplo, talvez você queira usar um EventTrigger para iniciar um conjunto de animações quando o ponteiro do mouse estiver sobre um determinado UI (interface do usuário)user interface (UI) controle.For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain UI (interface do usuário)user interface (UI) control. Ao contrário de Trigger , EventTrigger não tem nenhum conceito de término do estado, portanto, a ação não será desfeita quando a condição que gerou o evento não for mais verdadeira.Unlike Trigger, EventTrigger has no concept of termination of state, so the action will not be undone once the condition that raised the event is no longer true.

Observe que, ao usar um EventTrigger , você precisa escolher eventos que não interferem no comportamento inerente do seu controle.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. 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.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. 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 pela primeira vez pelo botão.For example, if you are styling a button and try to set the MouseDown event as the RoutedEvent of an EventTrigger, the EventTrigger never gets applied because the event first gets handled by the button. Em vez disso, você pode usar o PreviewMouseDown evento ou um evento diferente.Instead, you can use the PreviewMouseDown event or a different event.

Ao usar a vinculação de dados, se você estiver usando o TargetUpdated evento, deverá definir o NotifyOnTargetUpdated valor de seu Binding objeto como true para o evento a ser gerado.When using data binding, if you are using the TargetUpdated event, you must set the NotifyOnTargetUpdated value of your Binding object to true for the event to be raised.

Adicionar um TriggerAction filho a um EventTrigger objeto o adiciona implicitamente ao TriggerActionCollection para o EventTrigger objeto.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Construtores

EventTrigger()

Inicializa uma nova instância da classe EventTrigger.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent)

Inicializa uma nova instância da classe EventTrigger com o evento especificado.Initializes a new instance of the EventTrigger class with the specified event.

Propriedades

Actions

Obtém a coleção de ações a serem aplicadas durante o evento.Gets the collection of actions to apply when the event occurs.

DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Herdado de DependencyObject)
Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Herdado de DispatcherObject)
EnterActions

Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto gatilho se tornar ativo.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Essa propriedade não se aplica à classe EventTrigger.This property does not apply to the EventTrigger class.

(Herdado de TriggerBase)
ExitActions

Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto de gatilho se tornar inativo.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Essa propriedade não se aplica à classe EventTrigger.This property does not apply to the EventTrigger class.

(Herdado de TriggerBase)
IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Herdado de DependencyObject)
RoutedEvent

Obtém ou define o RoutedEvent que ativará esse gatilho.Gets or sets the RoutedEvent that will activate this trigger.

SourceName

Obtém ou define o nome do objeto com o evento que ativa o gatilho.Gets or sets the name of the object with the event that activates this trigger. Isso é usado somente por disparadores de elemento ou de modelo.This is only used by element triggers or template triggers.

Métodos

AddChild(Object)

Adiciona o objeto especificado à coleção Actions do gatilho de evento atual.Adds the specified object to the Actions collection of the current event trigger.

AddText(String)

Este método não é compatível e resulta em uma exceção.This method is not supported and results in an exception.

CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)
ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Herdado de DependencyObject)
CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Herdado de DependencyObject)
Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Herdado de DependencyObject)
GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Herdado de DependencyObject)
GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Herdado de DependencyObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificada.Re-evaluates the effective value for the specified dependency property.

(Herdado de DependencyObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Herdado de DependencyObject)
SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Herdado de DependencyObject)
ShouldSerializeActions()

Indica se os processos de serialização devem serializar o valor efetivo da propriedade Actions em instâncias dessa classe.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Herdado de DependencyObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Herdado de DispatcherObject)

Implantações explícitas de interface

IAddChild.AddChild(Object)

Adiciona um objeto filho.Adds a child object.

IAddChild.AddText(String)

Adiciona o conteúdo do texto de um nó ao objeto.Adds the text content of a node to the object.

Aplica-se a

Confira também