EventTrigger Clase

Definición

Representa un desencadenador que aplica un conjunto de acciones en respuesta a un 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
Herencia
Atributos
Implementaciones

Ejemplos

En este ejemplo se muestra cómo usar desencadenadores de eventos en un estilo para animar los MouseEnter eventos y MouseLeave de .FrameworkElement En este ejemplo, Style tiene establecido TargetTypeen Rectangle . Por lo tanto, no es necesario calificar los MouseEnter nombres de evento y MouseLeave con el nombre de clase.

<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 las Setterspropiedades , EnterActionsy ExitActions que aplican cambios o acciones en función del estado de determinadas propiedades, mientras que EventTrigger los objetos inician un conjunto de Actions cuando se produce un evento enrutado especificado. Por ejemplo, puede que desee usar para EventTrigger iniciar un conjunto de animaciones cuando el puntero del mouse está sobre un determinado control de interfaz de usuario (UI). A diferencia Triggerde , EventTrigger no tiene ningún concepto de terminación del estado, por lo que la acción no se deshacerá una vez que la condición que generó el evento ya no sea cierta.

Tenga en cuenta que al usar un EventTrigger, debe elegir eventos que no interfieran con el comportamiento inherente del control. Controles como Button o TextBox realizar acciones específicas en eventos de entrada de usuario, como clics del mouse y eventos de teclado. Por ejemplo, si va a aplicar un estilo a un botón e intenta establecer el MouseDown evento como de RoutedEvent , EventTriggerEventTrigger nunca se aplica porque el evento se controla primero mediante el botón. En su lugar, puede usar el PreviewMouseDown evento o un evento diferente.

Al usar el enlace de datos, si usa el TargetUpdated evento , debe establecer el NotifyOnTargetUpdated valor del Binding objeto true en para que se genere el evento.

Agregar un TriggerAction elemento secundario a un EventTrigger objeto lo agrega implícitamente al TriggerActionCollection objeto para el EventTrigger objeto .

Constructores

Nombre Description
EventTrigger()

Inicializa una nueva instancia de la clase EventTrigger.

EventTrigger(RoutedEvent)

Inicializa una nueva instancia de la EventTrigger clase con el evento especificado.

Propiedades

Nombre Description
Actions

Obtiene la colección de acciones que se aplicarán cuando se produce el evento.

DependencyObjectType

Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia.

(Heredado de DependencyObject)
Dispatcher

Obtiene el objeto al que DispatcherDispatcherObject está asociado.

(Heredado de DispatcherObject)
EnterActions

Obtiene una colección de TriggerAction objetos que se van a aplicar cuando el objeto desencadenador se activa. Esta propiedad no se aplica a la EventTrigger clase .

(Heredado de TriggerBase)
ExitActions

Obtiene una colección de TriggerAction objetos que se aplicarán cuando el objeto desencadenador se vuelve inactivo. Esta propiedad no se aplica a la EventTrigger clase .

(Heredado de TriggerBase)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura).

(Heredado de DependencyObject)
RoutedEvent

Obtiene o establece el RoutedEvent objeto que activará este desencadenador.

SourceName

Obtiene o establece el nombre del objeto con el evento que activa este desencadenador. Esto solo lo usan los desencadenadores de elemento o los desencadenadores de plantilla.

Métodos

Nombre Description
AddChild(Object)

Agrega el objeto especificado a la Actions colección del desencadenador de eventos actual.

AddText(String)

Este método no se admite y da como resultado una excepción.

CheckAccess()

Determina si el subproceso que llama tiene acceso a este DispatcherObject.

(Heredado de DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad. Un identificador especifica DependencyProperty la propiedad que se va a borrar.

(Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante .DependencyPropertyKey

(Heredado de DependencyObject)
CoerceValue(DependencyProperty)

Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier CoerceValueCallback función especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada DependencyObjecta .

(Heredado de DependencyObject)
Equals(Object)

Determina si un proporcionado DependencyObject es equivalente al objeto actual DependencyObject.

(Heredado de DependencyObject)
GetHashCode()

Obtiene un código hash para este DependencyObjectobjeto .

(Heredado de DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject.

(Heredado de DependencyObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de .DependencyObject

(Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada.

(Heredado de DependencyObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cada vez que se ha actualizado el valor efectivo de cualquier propiedad de dependencia en esto DependencyObject . La propiedad de dependencia específica que cambió se notifica en los datos del evento.

(Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.

(Heredado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar su origen de valor.

(Heredado de DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia.

(Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el DependencyPropertyKey identificador de la propiedad de dependencia.

(Heredado de DependencyObject)
ShouldSerializeActions()

Devuelve si los procesos de serialización deben serializar el valor efectivo de la Actions propiedad en instancias de esta clase.

ShouldSerializeProperty(DependencyProperty)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada.

(Heredado de DependencyObject)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
VerifyAccess()

Exige que el subproceso de llamada tenga acceso a este DispatcherObject.

(Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

Nombre Description
IAddChild.AddChild(Object)

Agrega un objeto secundario.

IAddChild.AddText(String)

Agrega el contenido de texto de un nodo al objeto .

Se aplica a

Consulte también