EventTrigger EventTrigger EventTrigger EventTrigger Class

Definición

Representa un desencadenador que aplica un conjunto de acciones en respuesta a un 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
type EventTrigger = class
    inherit TriggerBase
    interface IAddChild
Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild
Herencia
Atributos
Implementaciones

Ejemplos

En este ejemplo se muestra cómo utilizar desencadenadores de eventos en un estilo para animar la MouseEnter y MouseLeave eventos de un FrameworkElement.This example shows how to use event triggers in a style to animate the MouseEnter and MouseLeave events of a FrameworkElement. En este ejemplo, el Style tiene la TargetType establecido en Rectangle.In this example, the Style has the TargetType set to Rectangle. Por lo tanto, no es necesario calificar el MouseEnter y MouseLeave nombres de evento con el nombre de clase.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>

Comentarios

Trigger los objetos tienen la Setters, EnterActions, y ExitActions propiedades que se aplican los cambios o acciones en función del estado de determinadas propiedades, mientras que EventTrigger objetos iniciar un conjunto de Actions cuando se produce un evento enrutado 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 ejemplo, es posible que desee usar un EventTrigger para iniciar un conjunto de animaciones cuando el puntero del mouse está encima de un determinado interfaz de usuario (UI)user interface (UI) control.For example, you may want to use an EventTrigger to start a set of animations when the mouse pointer is over a certain interfaz de usuario (UI)user interface (UI) control. A diferencia de Trigger, EventTrigger no tiene ningún concepto de finalización de estado, por lo que la acción no puede deshacer una vez que la condición que provocó el evento ya no es true.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.

Tenga en cuenta que cuando se usa un EventTrigger, deberá elegir los eventos que no interfieren con el comportamiento inherente de su control.Note that when using an EventTrigger, you need to choose events that do not interfere with the inherent behavior of your control. Los controles como Button o TextBox realizar acciones específicas en los eventos de entrada de usuario como clics del mouse y los eventos de teclado.Controls such as Button or TextBox perform specific actions on user input events such as mouse clicks and keyboard events. Por ejemplo, si está creando un botón e intenta establecer el MouseDown eventos como la RoutedEvent de un EventTrigger, el EventTrigger nunca se aplica porque el evento en primer lugar se controla mediante el botón.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. En su lugar, puede usar el PreviewMouseDown evento o un evento diferente.Instead, you can use the PreviewMouseDown event or a different event.

Cuando se usa el enlace de datos, si está utilizando el TargetUpdated eventos, debe establecer el NotifyOnTargetUpdated valor de su Binding objeto true para que se produzca el evento.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.

Agregar un TriggerAction secundario a un EventTrigger objeto, agrega implícitamente a la TriggerActionCollection para el EventTrigger objeto.Adding a TriggerAction child to an EventTrigger object implicitly adds it to the TriggerActionCollection for the EventTrigger object.

Constructores

EventTrigger() EventTrigger() EventTrigger() EventTrigger()

Inicializa una nueva instancia de la clase EventTrigger.Initializes a new instance of the EventTrigger class.

EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent) EventTrigger(RoutedEvent)

Inicializa una nueva instancia de la clase EventTrigger con el evento especificado.Initializes a new instance of the EventTrigger class with the specified event.

Propiedades

Actions Actions Actions Actions

Obtiene la colección de acciones que se van a aplicar cuando se produzca el evento.Gets the collection of actions to apply when the event occurs.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtiene el Dispatcher esto DispatcherObject está asociado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar activo.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Esta propiedad no se aplica a la clase EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar inactivo.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Esta propiedad no se aplica a la clase EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
RoutedEvent RoutedEvent RoutedEvent RoutedEvent

Obtiene o establece el RoutedEvent que activará este desencadenador.Gets or sets the RoutedEvent that will activate this trigger.

SourceName SourceName SourceName SourceName

Obtiene o establece el nombre del objeto con el evento que activa este desencadenador.Gets or sets the name of the object with the event that activates this trigger. Solo se utiliza por desencadenadores de elementos o de plantillas.This is only used by element triggers or template triggers.

Métodos

AddChild(Object) AddChild(Object) AddChild(Object) AddChild(Object)

Agrega el objeto especificado a la colección Actions del desencadenador de eventos actual.Adds the specified object to the Actions collection of the current event trigger.

AddText(String) AddText(String) AddText(String) AddText(String)

Este método no se admite y tiene como resultado una excepción.This method is not supported and results in an exception.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina si el subproceso de llamada tiene acceso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen del valor.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions() ShouldSerializeActions()

Devuelve si los procesos de serialización deben serializar el valor efectivo de la propiedad Actions en instancias de esta clase.Returns whether serialization processes should serialize the effective value of the Actions property on instances of this class.

ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Exige que el subproceso que realiza la llamada tenga acceso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Agrega un objeto secundario.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Agrega el contenido de texto de un nodo al objeto.Adds the text content of a node to the object.

Se aplica a

Consulte también: