RoutedEvent Classe

  • Référence

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 Tapped, et l’identificateur RoutedEvent-type utilisé dans l’exemple est TappedEvent. L’emplacement classique pour les gestionnaires de câbles est Chargé pour une page ou OnApplyTemplate pour un contrôle avec 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

Notes

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 de sorte qu’il ait le comportement de l’événement routé.

Pour plus d’informations sur le fonctionnement des événements routés, consultez Vue d’ensemble des événements et des événements routés. Le RoutedEvent type fait partie de l’infrastructure des é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, de la même façon que 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, qui sont nommées à l’aide d’un modèle de nommage. Chaque RoutedEvent propriété est nommée d’après un événement plus le suffixe « Event ». Chacune de ces propriétés est l’identificateur de l’événement routé par lequel son nom commence. Par exemple, TappedEvent identifie l’événement routé Tapped vers le système d’événements.

Pour la plupart des utilisations du code d’application, il suffit de référencer l’événement par son nom en XAML ou par son nom d’entité de code dans le code 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 d’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 :

Notes

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