Leer en inglés

Compartir a través de

RoutedEvent Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Xaml
Editar

Representa un evento enrutado al sistema de eventos Windows Runtime.

C# 
[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)]
public sealed class RoutedEvent
C# 
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RoutedEvent
Herencia
Object RoutedEvent
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 se muestra la sintaxis básica para conectar un controlador de eventos con AddHandler y handledEventsToo como true. En este caso, el evento que se está conectando es Tapped y el identificador de tipo RoutedEvent usado en el ejemplo es TappedEvent. El lugar típico para conectar controladores se carga para una página o OnApplyTemplate para un control con plantilla.

C++ 
void MainPage::pageRoot_Tapped(Platform::Object^ sender, Windows::UI::Xaml::Input::TappedRoutedEventArgs^ e)
{
     //implementation
}
void MainPage::pageRoot_Loaded(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
     this->AddHandler(UIElement::TappedEvent, ref new TappedEventHandler(this, &MainPage::pageRoot_Tapped), true);
}
C# 
private void pageRoot_Tapped(object sender, TappedRoutedEventArgs e)
{
    //implementation
}
private void pageRoot_Loaded_1(object sender, RoutedEventArgs e)
{
    this.AddHandler(UIElement.TappedEvent, new TappedEventHandler(pageRoot_Tapped), true);
}

Comentarios

Nota

El sistema de eventos Windows Runtime no permite crear un evento enrutado personalizado; solo el Windows Runtime puede definir un evento de modo que tenga el comportamiento del evento enrutado.

Para obtener más información sobre cómo funcionan los eventos enrutados, consulta Información general sobre eventos y eventos enrutados. El tipo RoutedEvent forma parte de la infraestructura para eventos enrutados, pero no se usa RoutedEvent directamente en la programación típica de Windows Runtime aplicación.

El propósito del tipo RoutedEvent es servir como identificador para el sistema de eventos de Windows Runtime, similar a cómo DependencyProperty proporciona un tipo de identificador para el sistema de propiedades de dependencia. UIElement incluye varias propiedades estáticas de solo lectura del tipo RoutedEvent, que se denominan mediante un patrón de nomenclatura. Cada propiedad RoutedEvent se denomina después de un evento más el sufijo "Event". Cada propiedad de este tipo es el identificador del evento enrutado con el que comienza su nombre. Por ejemplo, TappedEvent identifica el evento enrutado Tapped al sistema de eventos.

Para la mayoría de los usos de código de la aplicación, simplemente hacer referencia al evento por nombre en XAML o por su nombre de entidad de código en el código es todo lo necesario para hacer referencia a un evento en un objeto, con el fin de agregar o quitar controladores. Los identificadores RoutedEvent solo son necesarios cuando se adjuntan controladores que se deben invocar incluso cuando los eventos enrutados se marcan previamente como controlados por el código del sistema o de la aplicación. La API que se usa para este escenario y la API que usa un valor RoutedEvent como parámetro son UIElement.AddHandler y UIElement.RemoveHandler. Para obtener más información, consulta Introducción a eventos y eventos enrutados.

Eventos que usan un identificador RoutedEvent

Esta es una lista de los eventos enrutados que tienen un identificador RoutedEvent y, por tanto, puede usar la técnica UIElement.AddHandler que hemos descrito:

Nota

GotFocus y LostFocus actúan como eventos enrutados, pero no tienen un identificador RoutedEvent, por lo que no puede usar AddHandler con ellos.

Se aplica a

Producto Versiones
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Consulte también