EventTrigger Clase

Definición

Espacio de nombres:

Windows.UI.Xaml

Representa un desencadenador que aplica un conjunto de acciones (guiones gráficos de animación) en respuesta a un evento. No se suele utilizar. Vea la sección Comentarios.

public ref class EventTrigger sealed : TriggerBase

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class EventTrigger final : TriggerBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

<EventTrigger>
  oneOrMoreBeginStoryboards
</EventTrigger>
 

Herencia

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo xaml se muestra la estructura básica para usar FrameworkElement.Triggers con su comportamiento de desencadenador frameworkElement.Loaded predeterminado para ejecutar una animación con guion gráfico. En este XAML se muestran los elementos contenedor EventTrigger y BeginStoryboard en una relación adecuada con cada uno con su sintaxis de propiedad de contenido XAML y las etiquetas de elementos de propiedad innecesarias omitidas.

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

Comentarios

Los desencadenadores, EventTrigger, Actions y BeginStoryboard no se usan normalmente. Estas API existen principalmente para la compatibilidad en XAML que se usó originalmente para Microsoft Silverlight. Para la mayoría de los escenarios en los que se usaron anteriormente desencadenadores de eventos, realice una de estas operaciones:

• Use animaciones integradas de la biblioteca de animaciones. Consulte Inicio rápido: Animar la interfaz de usuario mediante la biblioteca de animaciones.
• Para eventos en plantillas de control, use estados visuales y VisualStateManager. Consulte Animaciones con guion gráfico para estados visuales o Inicio rápido: Plantillas de control.
• En el caso de las animaciones de interfaz de usuario específicas de la aplicación, defina un controlador cargado en la página. Este controlador puede hacer referencia a un Guión gráfico definido en recursos de nivel de página y llamar al método Begin en ese Guión gráfico. Consulta Animaciones con guion gráfico.

Si eliges usar desencadenadores, en Windows Runtime XAML, el comportamiento predeterminado de los desencadenadores de eventos y el único evento que se puede usar para invocar un EventTrigger es FrameworkElement.Loaded. Dado que es el comportamiento predeterminado y el único habilitado, no establezca el atributo RoutedEvent . Solo tienes que usar xaml <EventTrigger>. Si establece RoutedEvent explícitamente (no recomendado), el único XAML que funciona es <EventTrigger RoutedEvent="FrameworkElement.Loaded">. Unqualified "Loaded", o cualquier otro valor, produce una excepción de análisis. Para obtener más información, consulta Desencadenadores.

Constructores

EventTrigger()

Inicializa una nueva instancia de la clase EventTrigger .

Propiedades

Actions	Obtiene la colección de objetos BeginStoryboard que mantiene este EventTrigger .
Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
RoutedEvent	Obtiene o establece el nombre del evento que inicia el desencadenador. Normalmente no se establece, vea Comentarios.

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Consulte también

• TriggerBase
• Triggers
• Animaciones con guion gráfico para estados visuales
• Inicio rápido: Plantillas de control