Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

RoutedEventArgs (Clase)

Contiene información de estado y datos de evento asociados a un evento enrutado.

System.Object
  System.EventArgs
    System.Windows.RoutedEventArgs
      Más información...

Espacio de nombres:  System.Windows
Ensamblado:  PresentationCore (en PresentationCore.dll)

public class RoutedEventArgs : EventArgs

El tipo RoutedEventArgs expone los siguientes miembros.

  NombreDescripción
Método públicoRoutedEventArgs()Inicializa una nueva instancia de la clase RoutedEventArgs.
Método públicoRoutedEventArgs(RoutedEvent) Inicializa una nueva instancia de la clase RoutedEventArgs, utilizando el identificador de evento enrutado proporcionado.
Método públicoRoutedEventArgs(RoutedEvent, Object)Inicializa una nueva instancia de la clase RoutedEventArgs, utilizando el identificador de evento enrutado proporcionado y dando la oportunidad de declarar un origen diferente para el evento.
Arriba

  NombreDescripción
Propiedad públicaHandledObtiene o establece un valor que indica el estado presente del control de eventos para un evento enrutado cuando recorre la ruta.
Propiedad públicaOriginalSourceObtiene el origen de notificación original tal como se determina en una mera prueba de aciertos, antes de cualquier posible ajuste de Source por parte de una clase primaria.
Propiedad públicaRoutedEventObtiene o establece el RoutedEvent asociado a esta instancia de RoutedEventArgs.
Propiedad públicaSourceObtiene o establece una referencia al objeto que ha producido el evento.
Arriba

  NombreDescripción
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoInvokeEventHandlerCuando se invalida en una clase derivada, proporciona una manera de invocar controladores de eventos de una forma específica del tipo, lo que puede aumentar la eficacia en la implementación base.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnSetSourceCuando se invalida en una clase derivada, proporciona un punto de entrada de devolución de llamada de notificación cada vez que cambia el valor de propiedad Source de una instancia.
Método públicoToString Devuelve una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

Se pueden utilizar diversos RoutedEventArgs con un RoutedEvent único. Esta clase es responsable de empaquetar datos de evento para RoutedEvent, proporcionando información de estado de evento adicional, y el sistema de eventos la utiliza para invocar el controlador asociado al evento enrutado.

For your custom event to support event routing, you need to register a RoutedEvent using the RegisterRoutedEvent method. This example demonstrates the basics of creating a custom routed event.

As shown in the following example, you first register a RoutedEvent using the RegisterRoutedEvent method. By convention, the RoutedEvent static field name should end with the suffix Event. In this example, the name of the event is Tap and the routing strategy of the event is Bubble. After the registration call, you can provide add-and-remove common language runtime (CLR) event accessors for the event.

Note that even though the event is raised through the OnTap virtual method in this particular example, how you raise your event or how your event responds to changes depends on your needs.

Note also that this example basically implements an entire subclass of Button; that subclass is built as a separate assembly and then instantiated as a custom class on a separate Extensible Application Markup Language (XAML) page. This is to illustrate the concept that subclassed controls can be inserted into trees composed of other controls, and that in this situation, custom events on these controls have the very same event routing capabilities as any native Windows Presentation Foundation (WPF) element does.


public class MyButtonSimple: Button
{
    // Create a custom routed event by first registering a RoutedEventID
    // This event uses the bubbling routing strategy
    public static readonly RoutedEvent TapEvent = EventManager.RegisterRoutedEvent(
        "Tap", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(MyButtonSimple));

    // Provide CLR accessors for the event
    public event RoutedEventHandler Tap
    {
            add { AddHandler(TapEvent, value); } 
            remove { RemoveHandler(TapEvent, value); }
    }

    // This method raises the Tap event
    void RaiseTapEvent()
    {
            RoutedEventArgs newEventArgs = new RoutedEventArgs(MyButtonSimple.TapEvent);
            RaiseEvent(newEventArgs);
    }
    // For demonstration purposes we raise the event when the MyButtonSimple is clicked
    protected override void OnClick()
    {
        RaiseTapEvent();
    }

}



<Window  
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary"
    x:Class="SDKSample.RoutedEventCustomApp"

    >
    <Window.Resources>
      <Style TargetType="{x:Type custom:MyButtonSimple}">
        <Setter Property="Height" Value="20"/>
        <Setter Property="Width" Value="250"/>
        <Setter Property="HorizontalAlignment" Value="Left"/>
        <Setter Property="Background" Value="#808080"/>
      </Style>
    </Window.Resources>
    <StackPanel Background="LightGray">
	    <custom:MyButtonSimple Name="mybtnsimple" Tap="TapHandler">Click to see Tap custom event work</custom:MyButtonSimple>
    </StackPanel>
</Window>


Tunneling events are created the same way, but with RoutingStrategy set to Tunnel in the registration call. By convention, tunneling events in WPF are prefixed with the word "Preview".

To see an example of how bubbling events work, see Cómo: Controlar un evento enrutado.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

System.Object
  System.EventArgs
    System.Windows.RoutedEventArgs
      System.Activities.Presentation.Toolbox.ToolCreatedEventArgs
      System.Windows.Controls.CalendarDateChangedEventArgs
      System.Windows.Controls.CalendarModeChangedEventArgs
      System.Windows.Controls.CleanUpVirtualizedItemEventArgs
      System.Windows.Controls.ContextMenuEventArgs
      System.Windows.Controls.InkCanvasGestureEventArgs
      System.Windows.Controls.InkCanvasStrokeCollectedEventArgs
      System.Windows.Controls.Primitives.DragCompletedEventArgs
      System.Windows.Controls.Primitives.DragDeltaEventArgs
      System.Windows.Controls.Primitives.DragStartedEventArgs
      System.Windows.Controls.Primitives.ScrollEventArgs
      System.Windows.Controls.ScrollChangedEventArgs
      System.Windows.Controls.SelectionChangedEventArgs
      System.Windows.Controls.TextChangedEventArgs
      System.Windows.Controls.ToolTipEventArgs
      System.Windows.Controls.ValidationErrorEventArgs
      System.Windows.Data.DataTransferEventArgs
      System.Windows.DataObjectEventArgs
      System.Windows.DragEventArgs
      System.Windows.ExceptionRoutedEventArgs
      System.Windows.GiveFeedbackEventArgs
      System.Windows.Input.AccessKeyPressedEventArgs
      System.Windows.Input.CanExecuteRoutedEventArgs
      System.Windows.Input.ExecutedRoutedEventArgs
      System.Windows.Input.InputEventArgs
      System.Windows.MediaScriptCommandRoutedEventArgs
      System.Windows.Navigation.RequestNavigateEventArgs
      System.Windows.QueryContinueDragEventArgs
      System.Windows.RequestBringIntoViewEventArgs
      System.Windows.RoutedPropertyChangedEventArgs<T>
      System.Windows.SizeChangedEventArgs
      System.Windows.SourceChangedEventArgs
Mostrar: