EventTrigger Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 . |