ISRoutedEventArgs Class

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

<DoNotObfuscateTypeAttribute()>
Public Class ISRoutedEventArgs 
   Inherits System.Windows.RoutedEventArgs

Dim instance As ISRoutedEventArgs

[DoNotObfuscateTypeAttribute()]
public class ISRoutedEventArgs : System.Windows.RoutedEventArgs

[DoNotObfuscateTypeAttribute()]
public ref class ISRoutedEventArgs : public System.Windows.RoutedEventArgs

Different RoutedEventArgs can be used with a single RoutedEvent. This class is responsible for packaging the event data for a RoutedEvent, providing extra event state information, and is used by the event system for invoking the handler associated with the routed event.

Routed event introduces bubbling and tunneling routing strategy.

In bubbling routing strategy, the event handlers on the event source are invoked. The routed event then routes to successive parent elements until reaching the element tree root. Most routed events use the bubbling routing strategy.

The following example shows how to handle the KeyDown routed event, which is a bubbling event.

XAML	Copy Code
<Grid x:Name="LayoutRoot"> <StackPanel> <Intersoft:UXTextBox Name="textBox1" Width="150" HorizontalAlignment="Left"/> <TextBlock Name="statusText" Width="200" HorizontalAlignment="Left"/> </StackPanel> </Grid>

XAML

Copy Code

<Grid x:Name="LayoutRoot">
        <StackPanel>
            <Intersoft:UXTextBox Name="textBox1" Width="150" HorizontalAlignment="Left"/>
            <TextBlock Name="statusText" Width="200" HorizontalAlignment="Left"/>
        </StackPanel>
</Grid>

C#	Copy Code
using System.Windows; using Intersoft.Client.Framework; using Intersoft.Client.UI.Navigation; using CoreInput = Intersoft.Client.Framework.Input; namespace ClientUIApplication_Docs.RoutedEvents { public partial class BubblingEvent : UXPage { public BubblingEvent() { InitializeComponent(); this.Loaded += new RoutedEventHandler(BubblingEvent_Loaded); } void BubblingEvent_Loaded(object sender, RoutedEventArgs e) { // Handle the KeyDown routed event in the LayoutRoot (Grid) element LayoutRoot.AddHandler(CoreInput.Keyboard.KeyDownEvent, new CoreInput.KeyEventHandler(OnKeyDown)); } void OnKeyDown(object sender, CoreInput.KeyEventArgs e) { // This function will be invoked when you type into the textbox, // although the event is actually handled in LayoutRoot, not the textbox element directly. statusText.Text = "Invoked from a bubbling event (KeyDownEvent): " + e.Key.ToString(); } } }

C#

Copy Code

using System.Windows;
using Intersoft.Client.Framework;
using Intersoft.Client.UI.Navigation;
using CoreInput = Intersoft.Client.Framework.Input;

namespace ClientUIApplication_Docs.RoutedEvents
{
    public partial class BubblingEvent : UXPage
    {
        public BubblingEvent()
        {
            InitializeComponent();
            this.Loaded += new RoutedEventHandler(BubblingEvent_Loaded);
        }

        void BubblingEvent_Loaded(object sender, RoutedEventArgs e)
        {
            // Handle the KeyDown routed event in the LayoutRoot (Grid) element
            LayoutRoot.AddHandler(CoreInput.Keyboard.KeyDownEvent, new CoreInput.KeyEventHandler(OnKeyDown));
        }

        void OnKeyDown(object sender, CoreInput.KeyEventArgs e)
        {
            // This function will be invoked when you type into the textbox,
            // although the event is actually handled in LayoutRoot, not the textbox element directly.
            statusText.Text = "Invoked from a bubbling event (KeyDownEvent): " + e.Key.ToString();
        }
    }
}

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ISRoutedEventArgs Members
Intersoft.Client.Framework Namespace

Concepts

Routed Events Overview