Langage

RoutedEvent Classe

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Représente un événement routé vers le système d’événements Windows Runtime.

public ref class RoutedEvent sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RoutedEvent final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RoutedEvent
Public NotInheritable Class RoutedEvent
Héritage
Object Platform::Object IInspectable RoutedEvent
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Exemples

Cet exemple montre la syntaxe de base pour le câblage d’un gestionnaire d’événements avec AddHandler et handledEventsToo en tant que true. Dans ce cas, l’événement câblé est tapé et l’identificateur RoutedEvent-type utilisé dans l’exemple est TappedEvent. L’emplacement typique des gestionnaires de câbles est chargé pour une page ou OnApplyTemplate pour un contrôle modèle.

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);
}

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);
}

Remarques

Note

Le système d'événements Windows Runtime ne vous permet pas de créer un événement routé personnalisé ; seul le Windows Runtime lui-même peut définir un événement tel qu'il a le comportement de l'événement routé.

Pour plus d’informations sur le fonctionnement des événements routés, consultez La vue d’ensemble des événements routés et des événements routés. Le RoutedEvent type fait partie de l'infrastructure pour les événements routés, mais vous n'utilisez RoutedEvent pas directement dans la programmation d'applications Windows Runtime standard.

L’objectif du RoutedEvent type est de servir d’identificateur pour le système d’événements Windows Runtime, comme la façon dont DependencyProperty fournit un type d’identificateur pour le système de propriétés de dépendance. UIElement inclut plusieurs propriétés statiques en lecture seule de type RoutedEvent, nommées à l’aide d’un modèle de nommage. Chaque RoutedEvent propriété est nommée après un événement et le suffixe « Event ». Chaque propriété de ce type est l’identificateur de l’événement routé que son nom commence par. Par exemple, TappedEvent identifie l’événement routé tapped vers le système d’événements.

Pour la plupart des utilisations de code d’application, il suffit de référencer l’événement par nom en XAML ou par son nom d’entité de code dans le code est tout ce qui est nécessaire pour référencer un événement sur un objet, à des fins d’ajout ou de suppression de gestionnaires. Les RoutedEvent identificateurs sont nécessaires uniquement lorsque vous attachez des gestionnaires qui doivent être appelés même lorsque les événements routés sont précédemment marqués comme gérés par le code système ou l’application. L’API que vous utilisez pour ce scénario et l’API qui utilise une RoutedEvent valeur comme paramètre sont UIElement.AddHandler et UIElement.RemoveHandler. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

Événements qui utilisent un identificateur RoutedEvent

Voici une liste des événements routés qui ont un RoutedEvent identificateur et peuvent donc utiliser la technique UIElement.AddHandler que nous avons décrite :

Note

GotFocus et LostFocus agissent comme des événements routés, mais n’ont pas d’identificateur RoutedEvent . Vous ne pouvez donc pas utiliser AddHandler avec eux.

S’applique à

Voir aussi