EventTrigger Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

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

Object

DispatcherObject

DependencyObject

TriggerBase

EventTrigger

Atributos

ContentPropertyAttribute

Implementaciones

IAddChild

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, tiene Style establecido en TargetTypeRectangle. 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 se encuentra 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 provocó el evento ya no sea verdadera.

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 realizan 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 RoutedEvent de , EventTriggerEventTrigger nunca se aplica porque el evento primero se controla 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

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

Propiedades

Actions	Obtiene la colección de acciones que se van a aplicar cuando se produzca el evento.
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
EnterActions	Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar activo. Esta propiedad no se aplica a la clase EventTrigger. (Heredado de TriggerBase)
ExitActions	Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar inactivo. Esta propiedad no se aplica a la clase EventTrigger. (Heredado de TriggerBase)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
RoutedEvent	Obtiene o establece el RoutedEvent que activará este desencadenador.
SourceName	Obtiene o establece el nombre del objeto con el evento que activa este desencadenador. Solo se utiliza por desencadenadores de elementos o de plantillas.

Métodos

AddChild(Object)	Agrega el objeto especificado a la colección Actions del desencadenador de eventos actual.
AddText(String)	Este método no se admite y tiene como resultado una excepción.
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (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 un DependencyPropertyKey. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. 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. (Heredado de DependencyObject)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en 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 un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de 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 el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
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. (Heredado de DependencyObject)
ShouldSerializeActions()	Devuelve si los procesos de serialización deben serializar el valor efectivo de la propiedad Actions 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 especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object)	Agrega un objeto secundario.
IAddChild.AddText(String)	Agrega el contenido de texto de un nodo al objeto.

Consulte también

• EventSetter
• Introducción al ejemplo de aplicación de estilos y plantillas