Click here to Skip to main content
14,364,487 members

Groupable ListView

Rate this:
4.72 (38 votes)
Please Sign up or sign in to vote.
4.72 (38 votes)
15 Sep 2006CPOL
Extended ListView with GUIs for easy grouping.

Sample Image - GroupableListView.png


Some time ago, I thought about writing a small extension to the ListView control. This would dynamically create a graphic user interface to allow the end-user create/modify groups, something like ‘GROUP BY’ in SQL. The control will automatically create a ToolStrip and a ToolStripButton for each column.


To use the control, just add ExListView.cs to your project, and switch the GroupsGUIs property to true, if you want to give the possibility to group items for the users.


  • GroupsGUIs - Show or not the ToolStrip to allow group items.
  • ToolStripImage - The image to show on ToolStripButtons of the groups.
  • ShowGroupLabel - Show or hide the 'ShowGroup' label.
  • ShowGroupLabelText - The 'ShowGroup' label. Default: 'Group by:'.


I prepared a small example project, with a ListView which contains some employees. Each employee has a name, sex, and a job. So, if the user wants to group the employees by sex, he just needs to press one button, and the ListView will analyze each ListViewItem and create groups for the data. It creates one group for each different data in selected colums.

Here you see an example of ListView, grouped by Sex and Job:

Sample Image - GroupableListView.png


To analyze and create the groups, I wrote a GroupBy(ColumnHeader[] Headers) method, it’s a simple thread-safe method with a few loops which add groups for each new different data found.

delegate void dGroupBy(ColumnHeader[] Headers);
public void GroupBy(ColumnHeader[] Headers)
    if (this.InvokeRequired)
        dGroupBy d = new dGroupBy(GroupBy);
        this.Invoke(d, new object[] { Headers });
        foreach (ListViewItem lvi in this.Items)
            string header = "";

            foreach (ColumnHeader ch in Headers)
                header += " " + 
            ListViewGroup group = 
                new ListViewGroup(header);
            ListViewGroup found = null;
            foreach (ListViewGroup g in Groups)
                if (g.Header == group.Header)
                { found = g; break; }
            if (found == null)

Sample Image - GroupableListView.png


  • 06/09/06 – v.1.01: Dock fill bug fixed.
  • 20/08/06 – Initial release.


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


About the Author

Chief Technology Officer Misakai Ltd.
Ireland Ireland
Roman Atachiants, Ph.D. is the architect behind service, a real-time, low-latency publish/subscribe service for IoT, Gaming. He is a software engineer and scientist with extensive experience in different computer science domains, programming languages/principles/patterns & frameworks.

His main expertise consists of C# and .NET platform, game technologies, cloud, human-computer interaction, big data and artificial intelligence. He has an extensive programming knowledge and R&D expertise.

Comments and Discussions

PraiseGreate example Pin
PetrosPetrosean9-Jan-16 2:39
memberPetrosPetrosean9-Jan-16 2:39 
QuestionBad Pin
Selçuk Dursun26-Apr-15 15:58
memberSelçuk Dursun26-Apr-15 15:58 
GeneralVery nice extension! Pin
Sam Jacobs17-Mar-10 13:40
memberSam Jacobs17-Mar-10 13:40 
Generalwrite text in Grouping Pin
Rohit Mahajan21-May-08 22:39
memberRohit Mahajan21-May-08 22:39 
GeneralVista Style Group/Sort Pin
Alexandru Stanciu27-Feb-08 18:54
memberAlexandru Stanciu27-Feb-08 18:54 
QuestionNo scroll bar Pin
Bill W15-Nov-07 5:29
memberBill W15-Nov-07 5:29 
QuestionStrange Issue Pin
-_-_-_-_-_22-Aug-07 22:10
member-_-_-_-_-_22-Aug-07 22:10 
AnswerRe: Strange Issue Pin
-_-_-_-_-_22-Aug-07 22:18
member-_-_-_-_-_22-Aug-07 22:18 
QuestionWidth-Problem when ListView in LargeIcon-Mode Pin
Stephan Mantel17-Jun-07 4:21
memberStephan Mantel17-Jun-07 4:21 
GeneralGrouping Sorted Pin
chancer10116-May-07 5:56
memberchancer10116-May-07 5:56 
GeneralSeem a bug Pin
dvptUml3-Apr-07 17:05
memberdvptUml3-Apr-07 17:05 
Generaluse combobox instead of a toolstrip... [modified] Pin
TheCardinal17-Oct-06 22:04
memberTheCardinal17-Oct-06 22:04 
QuestionExpand/Collapse Group Pin
riz3323-Oct-06 23:06
memberriz3323-Oct-06 23:06 
AnswerRe: Expand/Collapse Group Pin
sonofdaedalus24-Jan-07 9:23
membersonofdaedalus24-Jan-07 9:23 
QuestionRe: Expand/Collapse Group Pin
Soxiz11-Jun-07 12:32
memberSoxiz11-Jun-07 12:32 
QuestionA Question Pin
phonefans15-Sep-06 8:41
memberphonefans15-Sep-06 8:41 
AnswerRe: A Question Pin
Kel_15-Sep-06 10:47
memberKel_15-Sep-06 10:47 
GeneralRe: A Question Pin
phonefans15-Sep-06 17:52
memberphonefans15-Sep-06 17:52 
GeneralThanks but there is no group if listview is full dock Pin
jvhow5-Sep-06 21:59
memberjvhow5-Sep-06 21:59 
GeneralRe: Thanks but there is no group if listview is full dock Pin
Kel_5-Sep-06 23:00
memberKel_5-Sep-06 23:00 
GeneralI think its great. Pin
ilovthecov29-Aug-06 2:16
memberilovthecov29-Aug-06 2:16 
GeneralRe: I think its great. Pin
Kel_29-Aug-06 2:24
memberKel_29-Aug-06 2:24 
Questiontree diagram produced by ? Pin
BillWoodruff26-Aug-06 2:11
mveBillWoodruff26-Aug-06 2:11 
AnswerRe: tree diagram produced by ? Pin
Kel_26-Aug-06 6:51
memberKel_26-Aug-06 6:51 
QuestionWhy this code ???? Pin
DotNET7422-Aug-06 8:04
memberDotNET7422-Aug-06 8:04 

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.

Posted 20 Aug 2006


198 bookmarked