Partager via

Comment : ajouter la gestion de classe d'un événement routé

  • Article

Les événements routés peuvent être gérés par des gestionnaires de classes ou des gestionnaires d’instances sur n’importe quel nœud donné dans l’itinéraire. Les gestionnaires de classes sont appelés en premier et peuvent être utilisés par les implémentations de classes pour supprimer les événements de la gestion des instances ou introduire d’autres comportements spécifiques aux événements appartenant à des classes de base. Cet exemple illustre deux techniques étroitement liées à l’implémentation de gestionnaires de classes.

Exemple

Cet exemple utilise une classe personnalisée basée sur le Canvas panneau. Le principe de base de l’application est que la classe personnalisée introduit des comportements sur ses éléments enfants, y compris l’interception des clics de bouton gauche de la souris et leur marquage gérés, avant que la classe d’élément enfant ou les gestionnaires d’instances sur celui-ci ne soit appelée.

La UIElement classe expose une méthode virtuelle qui permet la gestion des classes sur l’événement PreviewMouseLeftButtonDown , en remplaçant simplement l’événement. Il s’agit du moyen le plus simple d’implémenter la gestion des classes si une telle méthode virtuelle est disponible quelque part dans la hiérarchie de votre classe. Le code suivant montre l’implémentation OnPreviewMouseLeftButtonDown dans le « MyEditContainer » dérivé de Canvas. L’implémentation marque l’événement comme géré dans les arguments, puis ajoute du code pour donner à l’élément source une modification visible de base.

protected override void OnPreviewMouseRightButtonDown(System.Windows.Input.MouseButtonEventArgs e)
{
    e.Handled = true; //suppress the click event and other leftmousebuttondown responders
    MyEditContainer ec = (MyEditContainer)e.Source;
    if (ec.EditState)
    { ec.EditState = false; }
    else
    { ec.EditState = true; }
    base.OnPreviewMouseRightButtonDown(e);
}

Protected Overrides Sub OnPreviewMouseRightButtonDown(ByVal e As System.Windows.Input.MouseButtonEventArgs)
    e.Handled = True 'suppress the click event and other leftmousebuttondown responders
    Dim ec As MyEditContainer = CType(e.Source, MyEditContainer)
    If ec.EditState Then
        ec.EditState = False
    Else
        ec.EditState = True
    End If
    MyBase.OnPreviewMouseRightButtonDown(e)
End Sub

Si aucune machine virtuelle n’est disponible sur les classes de base ou pour cette méthode particulière, la gestion des classes peut être ajoutée directement à l’aide d’une méthode utilitaire de la EventManager classe. RegisterClassHandler Cette méthode ne doit être appelée que dans l’initialisation statique des classes qui ajoutent la gestion des classes. Cet exemple ajoute un autre gestionnaire pour PreviewMouseLeftButtonDown , et dans ce cas, la classe inscrite est la classe personnalisée. En revanche, lors de l’utilisation des machines virtuelles, la classe inscrite est vraiment la UIElement classe de base. Dans les cas où les classes de base et les sous-classes chaque gestion des classes d’inscription, les gestionnaires de sous-classes sont appelés en premier. Le comportement d’une application serait que ce gestionnaire affiche d’abord sa boîte de message, puis que le changement visuel dans le gestionnaire de la méthode virtuelle s’affiche.

static MyEditContainer()
{
  EventManager.RegisterClassHandler(typeof(MyEditContainer), PreviewMouseRightButtonDownEvent, new RoutedEventHandler(LocalOnMouseRightButtonDown));
}
internal static void LocalOnMouseRightButtonDown(object sender, RoutedEventArgs e)
{
  MessageBox.Show("this is invoked before the On* class handler on UIElement");
  //e.Handled = true; //uncommenting this would cause ONLY the subclass' class handler to respond
}

Shared Sub New()
    EventManager.RegisterClassHandler(GetType(MyEditContainer), PreviewMouseRightButtonDownEvent, New RoutedEventHandler(AddressOf LocalOnMouseRightButtonDown))
End Sub
Friend Shared Sub LocalOnMouseRightButtonDown(ByVal sender As Object, ByVal e As RoutedEventArgs)
    MessageBox.Show("this is invoked before the On* class handler on UIElement")
    'e.Handled = True //uncommenting this would cause ONLY the subclass' class handler to respond
End Sub

Voir aussi