EventTrigger Clase

Definición

Espacio de nombres:

Microsoft.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

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

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

Public NotInheritable Class EventTrigger
Inherits TriggerBase

Herencia

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

Atributos

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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. Este XAML muestra los elementos contenedor EventTrigger y BeginStoryboard en una relación adecuada con cada uno de ellos 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 por compatibilidad en XAML que se usa 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:

• Usa animaciones integradas de la biblioteca de animaciones. Consulta Animaciones en XAML.
• Para los eventos de las plantillas de control, use estados visuales y VisualStateManager. Consulta Plantillas de control XAML.
• Para 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 valor predeterminado y el único comportamiento 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	Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. En su lugar, use DispatcherQueue . (Heredado de DependencyObject)
DispatcherQueue	Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue 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 mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Consulte también

• TriggerBase
• Triggers
• Plantillas de control XAML