Skip to main content

How to copy event handlers from one control to another

Today at work, one of my partners in crime were working on a crazy customer requirement and ask me if I think that would be possible to copy event handlers from one control to another at run time and keeps things working correctly. I said yes, I think it’s possible and must be easy too, let’s take a look…

After a couple of minutes, we figure out that the Control class doesn´t expose any public method or property to get access to the collection of delegates attached to the control’s events.

I did a fair amount of web research and found a lot of partial solutions but none that fit our needs. So I decide to roll my own solution, post it, and may help some who is facing the very same problem.

Normally when we are working with events, we hook them up with handlers, writing a piece of code like this:

textBox1.TextChanged += (s, e) => MessageBox.Show("Hi there from handler 1");
 
It’s also common to attach more than one handler to the same event:
 
textBox1.TextChanged += (s, e) => MessageBox.Show("Hi there from handler 1");
textBox1.TextChanged += (s, e) => MessageBox.Show("Hi there from handler 2");
//*(I’m using lambdas for shortness)

The requirement is provide some mechanism to create a new textbox  at runtime (let say textBox2) and attach to it the list of handlers that had been attached to the textBox1 at design time. (We also need to destroy textBox1, but this is not the point)

In this post I’m assuming that you are familiar with events and you know the basic of how they work, so I’m not going to cover in deep the “events machinery” in .NET. However in order to move on, we need to review how handlers are (internally) attached to or detached from an event in .NET.
The snippet above is from the (decompiled) control class of the .NET Framework:

private static readonly object EventText = new object();

public event EventHandler TextChanged {
    add { 
        Events.AddHandler(EventText, value); 
    }
    remove { 
        Events.RemoveHandler(EventText, value);
    }
}

Here “EventText” is the field (key) that the Control class uses to point a list of handlers (delegates) to a given event, in this case “TextChanged”.

So when we write:
textBox1.TextChanged += some delegate…
Internally, we are adding that delegate to the list of handlers. 
    add { 
        Events.AddHandler(EventText, value); 
    }
 
Now that we understand the very basics about how internally works the process of add/remove event handlers, we can imagine that if somehow we can get the value of the property “Events” and know the correct key, we may able to pull off the collection of delegates attached to a specified event and iterating thru that collection, hopefully, get the delegates and accomplish our mission ;)
 
This solution makes heavily use reflection, mainly because as I said before, there is no public API to work against it. For instance, the property “Events”, is marked as protected in the Control class and there isn´t another way to access it (unless you are using extended controls or a like, but this isn’t our case) 

The current implementation only works with events declared on the Control class. You can get the full list of supported events using .NET Reflector or a similar tool. If the event that you are looking for is not supported by the current implementation, you can make it work by modifying a few lines of code (more on this later).
 
First of all we need to get the list of handlers attached to an event and this handy method take cares of that.
 
public Dictionary<stringDictionary<objectDelegate[]>> GetHandlersFrom(Control ctrl) {

    var ctrlEventsCollection = (EventHandlerList)
        typeof(Control).GetProperty("Events"
        BF.GetProperty | BF.NonPublic | BF.Instance)
        .GetValue(ctrl, null);
            
    var headInfo = typeof(EventHandlerList)
                   .GetField("head"BF.Instance | BF.NonPublic);

    var handlers = BuildList(headInfo, ctrlEventsCollection); 
    var eventName = GetEventNameFromKey(ctrl, handlers.First().Key); 
    var result = new Dictionary<stringDictionary<objectDelegate[]>> 
        {{
            eventName, handlers 
        }};

     return result;
}
 
Now we have the delegates but we don´t know (yet) which is the event in the new control that we have to hookup.  At this point we’re going to use a dictionary that contains some sort of map between the event’s name and the corresponding field in the Control class. Based on the key that we already have and using some reflection magic, we can attach those delegates to the correct event in our brand new control.
 
//The mapping
_keyEventNameMapping = new Dictionary<stringstring>{
                {"EventAutoSizeChanged""AutoSizeChanged"},
                {"EventBackColor""BackColorChanged"},
                //etc, etc…
 
 
How can I make it work if the event that I’m interested in is not defined in the control class?
Easy, if you want to extend this solution to work with events that are not defined in the control class
*  Add the map in the _keyEventNameMapping field
* Modify this line in the CopyTo extension method
 
//Instead of Control use the class you need
var info = typeof(Control).GetField(innerKeyFieldName,
          BF.GetField | BF.Static | BF.NonPublic | BF.DeclaredOnly);
 
 
Running the sample Application:
Once you download the sample app. run it and you’ll see a form with two textboxes and a button. If you enter text in the textbox labeled “Source” you’ll notice that two events will fire and the handlers attached to those events will show a message. Nothing should happen if you enter text in the textbox labeled destination.
Now, press the button named “Copy event handlers” and enters some text in the textbox labeled destination. If all went well, you should be seen the messages from the event handlers attached to the source textbox, now attached to the destination textbox.
 
Using the code:
For copying handlers from one control to another you just need those two lines of code.
 
var _copyHelper = new CopyEventHandlers();
_copyHelper.GetHandlersFrom(textBox1).CopyTo(textBox2);
 


Download Source
Download Sample App
If you have any question about using the code, don’t hesitate con contact me, I’ll be glad to help.

Comments

Popular posts from this blog

How to create MS Word documents from Office templates using C#

The OpenXML SDK allows you to do pretty much anything you want with office files such as Excel, Word, etc… While many people like this library, I found it complex, unintuitive and poorly documented, not to mention the awful xml format that uses under the hood to represent the documents, styles, etc. So I decided not to use it and build my own solution. If you, like me, don’t like that library, you will find in this post an alternative approach to build word documents from templates using c#.
A neat trick to work with Office is to use the macro recorder to understand how things work. The macro recorder allows you to start a macro, do something by hand, stop it, and then take a look at the generated VBA code. Once you do this, you are pretty much set.
This is how it looks the template I’am going to use.


Note: save the file as a Word template (.dotx)
This is the code to create Word documents from C#:

By running the code, you should get a document that looks like this.


Note that the font, forma…

Printing html using the embedded web browser control

In this post I’ll try to answer some questions about the web browser control and provide some workarounds for known issues involved in the printing process.
I'm assuming that you have some experience with the web browser control and basic knowledge of COM and hosting APIs. So I’m not going to cover those topics.
At the bottom of this page I’ve added the links to download a small library I wrote that takes care of printing HTML and a demo app so you can try it out without having to write any code by yourself.
Using the code The HtmlPrinter class will allow you to print html from an URL or just passing the html as string, you can also specify the title and the number of copies you want to print. The code may look something like this: Now that we know how to use the API let get answer some questions.
Why my app crashes when I try to print multiple copies of a page? Well, apparently when you send a lot of print commands to the web browser control, there is a lot of COM crap in between that l…

WinForms, paging the DataGridView the right way

I know this may sound like old history, but in the enterprise world there is still a lot of WinForms development. Just a couple of days ago, I had to implement a custom DataGridView capable to work over a butt load of data (100K+ records) and keep responses times acceptables.
I thought paging will be a good way to go, and as WinForms is pretty old nowadays, I supposed it will be easy to find a couple examples on the web.
While in fact I found examples, all of them were incompletes and/or they wouldn't perform well in real world apps... So I decided to roll my own component and post it online. Hopefully, someone else will find it useful ;).


The bread and butter of this solution relies on LINQ and deferred execution. As LINQ takes care of all complicated work, it was quite easy to implement.
This component also supports conditional format, sorting and some search capabilities, but in this post I will concentrate on paging only (I'll cover the rest of the features in future posts)…