Click here to Skip to main content
15,860,972 members
Articles / Programming Languages / C#
Article

Background applications listening for keyboard activity

Rate me:
Please Sign up or sign in to vote.
4.80/5 (30 votes)
19 Jan 2005CPOL4 min read 199.6K   10.6K   96   37
Class for capturing keyboard events.

Sample Image - KeyboardListener.gif

Introduction

The KeyboardListener class presented here allows capturing keyboard events even when another application is running in the foreground. Several threads inside your application might be listening for events in parallel, each handling the events in its own way.

In case you are only looking for a means to add hotkey support to your application, you might also want to take a look at the CodeProject article '.NET System wide hotkey component'. However, if you have other plans with respect to handling keyboard events inside your application, this KeyboardListener class might be the one you're looking for.

The KeyboardListener class can only be used on Windows XP because its implementation depends on the Win32 methods RegisterRawInputDevices and GetRawInputData which are currently only available on XP.

Using the code

1. The demo application

Let's start with the easy part: using the class inside an application. The demo application is a plain .NET application containing only one form that in turn only contains one text label (see demo project). The implementation of the Form1_Load method that is called whenever the form is loaded only adds a new EventHandler to the static s_KeyEventHandler event exported by the KeyboardListener class. Of course, you are free to add multiple EventHandler instances on several locations inside your application.

C#
private void Form1_Load(object sender, System.EventArgs e)
{
    // Watch for keyboard activity
    KeyboardListener.s_KeyEventHandler += new 
           EventHandler(KeyboardListener_s_KeyEventHandler);
}

The KeyboardListener_s_KeyEventHandler method that is passed to the EventHandler constructor analyzes the arguments, updates the text label lblKeyPressed on the form with some key information, and changes the back color of the form depending on the action of the key: when a key is pressed the background becomes red; when it is released, it becomes green again.

C#
private void KeyboardListener_s_KeyEventHandler(object sender, EventArgs e)
{
    KeyboardListener.UniversalKeyEventArgs eventArgs = 
                                (KeyboardListener.UniversalKeyEventArgs)e;
    lblKeyPressed.Text = string.Format("Key = {0}  Msg = {1}  Text = {2}", 
                     eventArgs.m_Key, eventArgs.m_Msg, eventArgs.KeyData);

    // 256 : key down    257 : key up
    if(eventArgs.m_Msg == 256)
    {
        this.BackColor = Color.Red;
    }
    else
    {
       this.BackColor = Color.Green;
    }
}

2. The KeyboardListener class

The KeyboardListener class is made up of three important parts. First, there is the already mentioned static EventHandler variable s_KeyEventHandler. Every application thread that is interested to receive keyboard events can subscribe to this event.

C#
public static event EventHandler s_KeyEventHandler;

Second, there is the static KeyHandler method that is called whenever a keyboard event occurs. It loops across all EventHandler instances contained by s_KeyEventHandler calling each one with a UniversalKeyEventArgs instance that holds the key and message provided by the keyboard event. The advantage of looping across all delegates is that by adding a try/catch block to the loop, an EventHandler can fail while all other EventHandler instances still get called. In other words, one subscriber that fails doesn't prevent other subscribers from being called.

C#
private static void KeyHandler(ushort key, uint msg)
{
    if(s_KeyEventHandler != null)
    {
        Delegate[] delegates = s_KeyEventHandler.GetInvocationList();

        foreach(Delegate del in delegates)
        {
            EventHandler sink = (EventHandler)del;

            try
            {
                // This is a static class, therefore null
                // is passed as the object reference
                sink(null,new UniversalKeyEventArgs(key,msg));
            }

            // You can add some meaningful code to this catch block
            catch{};
        }
    }
}

Last, there is the ListeningWindow class. As the name might suggest, an instance of such a class is used to listen. It listens for keyboard events to happen. In fact, there is only one instance of this class. This instance is created when the static constructor for the KeyboardListener class is called. Looking at the ListeningWindow constructor below, you see that it needs a delegate when it gets constructed. This delegate happens to be the KeyHandler mentioned above. So, while the application is running, whenever the ListeningWindow finds out about a keyboard event, it calls the KeyHandler delegate that in turn calls all installed EventHandlers.

public ListeningWindow(KeyDelegate keyHandlerFunction)
{
    m_KeyHandler = keyHandlerFunction;

    CreateParams cp = new CreateParams();

    // Fill in the CreateParams details.
    cp.Caption = "Hidden window";
    cp.ClassName = null;
    cp.X = 0x7FFFFFFF;
    cp.Y = 0x7FFFFFFF;
    cp.Height = 0;
    cp.Width = 0;
    cp.Style = WS_CLIPCHILDREN;

    // Create the actual invisible window
    this.CreateHandle(cp);

    // Register for Keyboard notification
    unsafe
    {
        try
        {
            RAWINPUTDEV myRawDevice = new RAWINPUTDEV();
            myRawDevice.usUsagePage = 0x01;
            myRawDevice.usUsage = 0x06;
            myRawDevice.dwFlags = RIDEV_INPUTSINK;
            myRawDevice.hwndTarget = this.Handle.ToPointer();

            if (RegisterRawInputDevices(&myRawDevice, 1, 
                         (uint)sizeof(RAWINPUTDEV)) == false) 
            {
                int err = Marshal.GetLastWin32Error();
                throw new Win32Exception(err, 
                       "ListeningWindow::RegisterRawInputDevices");
            }
        }

        catch {throw;}
    }
}

The ListeningWindow class, which is a subclass of the NativeWindow class, only contains two interesting definitions: the constructor and the WndProc method.

Inside the ListeningWindow constructor, an invisible window is created after which it is registered to receive keyboard input messages. These messages are analyzed by the WndProc method that is overriding the NativeWindow base class method. Whenever the WndProc method receives a keyboard message, it checks whether it differs from the previous message and if so, it calls the delegate installed inside the ListeningWindow constructor.

protected override void WndProc(ref Message m)
{
    ...
    receivedBytes = 
      (uint)GetRawInputData((RAWINPUTHKEYBOARD*)(m.LParam.ToPointer()), 
      RID_INPUT, lpb, &dwSize, sizeof_RAWINPUTHEADER);
    if ( receivedBytes == dwSize )
    {
        RAWINPUTHKEYBOARD* keybData = (RAWINPUTHKEYBOARD*)lpb;

        // Finally, analyze the data
        if(keybData->header.dwType == RIM_TYPEKEYBOARD)
        {
            if((m_PrevControlKey != keybData->VKey) || 
               (m_PrevMessage != keybData->Message))
            {
                m_PrevControlKey = keybData->VKey;
                m_PrevMessage = keybData->Message;

                // Call the delegate in case data satisfies
                m_KeyHandler(keybData->VKey,keybData->Message);
            }
        }
    }
    ...
}

Using PInvoke

The two methods that are key to the KeyboardListener class implementation are the RegisterRawInputDevices and the GetRawInputData methods. They enable capturing and handling keyboard events in the background. Since these calls are not supported by .NET, they are called via the PInvoke mechanism.

C#
[DllImport("User32.dll",CharSet = CharSet.Ansi,SetLastError=true)] 
[return : MarshalAs(UnmanagedType.Bool)] 
internal static extern unsafe bool 
   RegisterRawInputDevices( RAWINPUTDEV* rawInputDevices, 
   uint numDevices, uint size);

[DllImport("User32.dll",CharSet = CharSet.Ansi,SetLastError=true)]
[return : MarshalAs(UnmanagedType.I4)]
internal static extern unsafe int GetRawInputData( void* hRawInput, 
   uint uiCommand, byte* pData, uint* pcbSize, uint cbSizeHeader);

Future ideas

  1. The UniversalKeyEventArgs is a sub-class of the EventArgs class and you might ask why we need it. Well, frankly, you can do without. But then you will have to assemble the correct Keys instance to pass as a parameter to the EventArgs constructor. In this release, I went for an easy way out that is certainly something that can be improved in a future release.
  2. Using the same technology, a MouseListener class can be created. See my next article.

History

  • 20 January 2005, Version 1.0.0, Initial release.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer
Belgium Belgium
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralGood work ... Pin
Daniele Ferrero27-Jul-06 3:13
Daniele Ferrero27-Jul-06 3:13 
GeneralModifiers Pin
raven132430-May-06 15:04
raven132430-May-06 15:04 
GeneralRe: Modifiers Pin
raven132430-May-06 16:12
raven132430-May-06 16:12 
GeneralRe: Modifiers Pin
raven132431-May-06 3:11
raven132431-May-06 3:11 
GeneralShortkeys Pin
MoGiT13-Apr-06 2:57
MoGiT13-Apr-06 2:57 
GeneralMake it run in the background in invisible mode Pin
coosa10-Apr-06 13:52
coosa10-Apr-06 13:52 
GeneralRe: Make it run in the background in invisible mode Pin
Dominique Bijnens10-Apr-06 23:57
Dominique Bijnens10-Apr-06 23:57 
GeneralRe: Make it run in the background in invisible mode Pin
Lev Vayner.14-Dec-06 12:22
professionalLev Vayner.14-Dec-06 12:22 
I've done it and its very easy!! I just hope its not for maliscious purposes.
Anywho, just add

this.ShowInTaskbar = false;
this.Visible = false;

after the KeyEventHander deligate is initialized in Form1_Load function.
QuestionWhen this class is called??? Pin
Alex Cutovoi3-Oct-05 3:32
Alex Cutovoi3-Oct-05 3:32 
AnswerRe: When this class is called??? Pin
Dominique Bijnens3-Oct-05 23:56
Dominique Bijnens3-Oct-05 23:56 
GeneralGetting Twice the same keycode data Pin
Jatinath14-Nov-12 0:42
professionalJatinath14-Nov-12 0:42 
GeneralGetting Twice the same keycode data Pin
Jatinath14-Nov-12 0:43
professionalJatinath14-Nov-12 0:43 
GeneralKeyboard Detection Pin
Babu Aboobacker E.I31-Jan-05 18:04
Babu Aboobacker E.I31-Jan-05 18:04 
GeneralMouseListener Pin
Andrea Cioli27-Jan-05 23:42
Andrea Cioli27-Jan-05 23:42 
GeneralRe: MouseListener Pin
Dominique Bijnens30-Jan-05 21:21
Dominique Bijnens30-Jan-05 21:21 
GeneralRe: MouseListener Pin
Andrea Cioli4-Feb-05 6:12
Andrea Cioli4-Feb-05 6:12 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.