Click here to Skip to main content
Click here to Skip to main content

An editable multi-line listbox for .NET

, 4 Aug 2002 Ms-PL
Rate this:
Please Sign up or sign in to vote.
An owner drawn listbox that supports multi-line word-wrapped text as well as in-place editing.

Overview

MultiLineListBox is a fully owner drawn ListBox derived class that supports multi-line items as well as in-place editing of items. It has been wrapped into a class library for ease of deployment. You don't have to do anything special when using it. Just use it as you would use a normal list box. Whenever you add a string that's too long for a single line, the MultiLineListBox will wrap the long string into multiple lines. Editing items is also easy. Just right click on any item or press the F2 key when an item is selected, this will superimpose an edit box exactly on top of the selected or clicked item. You can make your changes and either press the Enter key or you can click anywhere else within the list box for the modifications to take effect. If you want to cancel the changes and get back to the original text, simply hit the Escape key.

The class will not allow you to make an item null, and will pop up a message box alert and won't let you take focus away from the item till you've either cancelled the modification by pressing Escape or you have entered some text.

If you enter a lot of text into the item edit text box, the overlaid text box itself will allow you to scroll vertically.

Using the class

Simply add the control to your toolbox. Now use it just as you  would be using a regular list box. Try entering long strings. And run the program. Try editing the strings by either pressing the F2 key or by right clicking on an item. See how the alert message box pops up when you try to modify an item string to a null string. I added this feature because in the project where I'll be using this, null strings are strictly forbidden. Perhaps you might want to allow null strings, if so feel free to comment out the relevant code in the source code.

Technical details

Well obviously the DrawMode is set to DrawMode.OwnerDrawVariable. We need to figure out the height required per item. This is how we do it it in the OnMeasureItem override,

//...

string s = Items[e.Index].ToString();
SizeF sf = e.Graphics.MeasureString(s,Font,Width);
int htex = (e.Index==0) ? 15 : 10;
e.ItemHeight = (int)sf.Height + htex;			
e.ItemWidth = Width;

//...

Now we need to actually draw the  text as this is an owner drawn list box. We override OnDrawItem as shown below.

protected override void OnDrawItem(DrawItemEventArgs e)
{
    //...

    /*chk if list box has any items*/
    if(e.Index > -1)
    {
        string s = Items[e.Index].ToString();                           

        /*Normal items*/
        if((e.State & DrawItemState.Focus)==0)
        {
            e.Graphics.FillRectangle(
                new SolidBrush(SystemColors.Window),
                e.Bounds);
            e.Graphics.DrawString(s,Font,
                new SolidBrush(SystemColors.WindowText),
                e.Bounds);              
            e.Graphics.DrawRectangle(
                new Pen(SystemColors.Highlight),e.Bounds);              
        }
        else /*Selected item, needs highlighting*/
        {
            e.Graphics.FillRectangle(
                new SolidBrush(SystemColors.Highlight),
                e.Bounds);
            e.Graphics.DrawString(s,Font,
                new SolidBrush(SystemColors.HighlightText),
                e.Bounds);
        }
    }
}

Well, so far so good. Now for the in-place editing, what we do is to derive a class from TextBox and add it to our list box. And we handle the OnMouseUp method to check if the user has right clicked an item.

protected override void OnMouseUp(
    System.Windows.Forms.MouseEventArgs e)
{
    //...


        /* Is it a right mouse clk? */
        if(e.Button == MouseButtons.Right)
        {

            string s = Items[index].ToString();
            Rectangle rect = GetItemRectangle(index);

            //overlay the text box right over
            //the list box item to be edited
            tbox.Location = new Point(rect.X,rect.Y);
            tbox.Size = new Size(rect.Width,rect.Height);
            tbox.Text = s;              
            tbox.index = index;
            tbox.SelectAll();
            tbox.Show();
            tbox.Focus();
        }

    //...
}

And similarly we handle OnKeyDown for checking whether the user has pressed the F2 key.

protected override void OnKeyDown(KeyEventArgs e)
{
    if(e.KeyData == Keys.F2)
    {
        //...

            string s = Items[index].ToString();
            Rectangle rect = GetItemRectangle(index);

            tbox.Location = new Point(rect.X,rect.Y);
            tbox.Size = new Size(rect.Width,rect.Height);               
            
        //...
    }
    
    //...
}

In the TextBox derived class we override both OnLostFocus and OnKeyPress (check for Enter key) and make checks to ensure that the user will not enter a null string. The source code can be examined for the finer details, but basically that's all the class does and this class is a private inner class of the MultiLineListBox class. I also check for the Escape key in the OnKeyPress handler to allow the user to cancel a modification.

Conclusion

I hope to get your feedback - both good and bad. I'd also like to know whether anyone actually found this useful enough to use in an application. Or whether the class can be improved in any particular manner. As for myself I spent the whole day dealing with various kinds of issues I ran into, mostly due to my custom control coding inexperience rather than due to any great difficulty in what I was attempting.

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)

Share

About the Author

Nish Nishant

United States United States
Nish Nishant is a Software Architect/Consultant based out of Columbus, Ohio. He has over 15 years of software industry experience in various roles including Lead Software Architect, Principal Software Engineer, and Product Manager. Nish is a recipient of the annual Microsoft Visual C++ MVP Award since 2002 (13 consecutive awards as of 2014).

Nish is an industry acknowledged expert in the Microsoft technology stack. He authored
C++/CLI in Action for Manning Publications in 2005, and had previously co-authored
Extending MFC Applications with the .NET Framework for Addison Wesley in 2003. In addition, he has over 140 published technology articles on CodeProject.com and another 250+ blog articles on his
WordPress blog. Nish is vastly experienced in team management, mentoring teams, and directing all stages of software development.

Contact Nish : You can reach Nish on his google email id voidnish.

Website and Blog

Comments and Discussions

 
QuestionBold Text PinmemberColin Anderson30-Dec-14 6:06 
QuestionIs it possible to highlight words in the list item ? Pinmemberdeep-it27-Aug-12 21:16 
QuestionHow to add an item dynamically to this editable list box? Pinmemberharishreddyk23-Jul-12 20:31 
GeneralMy vote of 5 PinmemberDavid the Coder11-Dec-10 15:16 
GeneralProblem when String is too long PinmemberZanpluktou23-Sep-10 10:00 
When a string is too long for the item, then it just cuts off and does not display the entire string rather a certain length and then stops. I'm not sure why this is, since we have scrollbar for the listbox, it should draw the entire item height required by the measure item yet it does not. Is there any fix for this? Only occurs on height as an issue.
GeneralCode Not Present Pinmemberdasprdav31-Aug-10 10:02 
GeneralRe: Code Not Present PinmvpNishant Sivakumar31-Aug-10 10:05 
Generalthx for the post and I have one question if you still have time for such projects ;) PinmemberTKluza11-Jan-10 8:29 
GeneralNish PinmemberWillie Hall24-Jun-09 10:52 
GeneralAdded support for "SetSelected" [modified] PinmemberMember 425856019-Jan-09 12:15 
GeneraldataSource Pinmemberbfis10813729-Jul-08 8:03 
GeneralShweet!!!! Pinmembershahbaznihal11-Jul-08 9:07 
GeneralNice work! but one problem when editing Pinmemberseanzcan1-Jun-08 10:00 
GeneralGet Text Pinmemberg8kpr007-Dec-06 15:42 
GeneralThis is nice PinmemberKrenshau755-Nov-06 18:16 
GeneralSlight Update to allow for Multi-Select PinmemberMoxie13-Oct-06 9:09 
GeneralRe: Slight Update to allow for Multi-Select PinmemberMoxie13-Oct-06 9:11 
GeneralCool PinmemberPaul Conrad8-Jul-06 8:22 
GeneralGreat Job DUDE [modified] PinmemberPrashanth Kota11-Jun-06 12:49 
QuestionProblem Adding a User defined Index ID to the Listbox Pinmemberkkungli26-May-06 15:22 
Generalgood work, but problem with item size Pinmembersandrokan25-May-06 6:42 
QuestionCF version? Pinmembernaveed2-Feb-06 14:19 
GeneralNice "sample" text in the image Pinmembermalharone17-Oct-05 11:57 
Generalproblem with OnMeasureItem Pinmembervomax13-Oct-05 14:33 
GeneralThanks Nish PinmemberMatt Philmon4-Apr-05 10:10 

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

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

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150414.1 | Last Updated 5 Aug 2002
Article Copyright 2002 by Nish Nishant
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid