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

ListViewSortManager control

, 12 Dec 2004
Rate this:
Please Sign up or sign in to vote.
Add column sorting to the ListView control the easy way.

Introduction

.NET's ListView control is a nice wrapper around the native List control, but the support for column sorting falls a bit short of what's commonly necessary. Some solutions to this problem require you to derive from a class that implements column sorting however. Since inheritance introduces very tight coupling between components, it is not the appropriate solution in every case. For example, your custom ListView derives from a class that implements functionality that you need except for column sorting and you cannot change the base class.

ListViewSortManager provides several useful features:

  • Easy to use.
  • Case-sensitive (ListViewTextSort) and case-insensitive (ListViewTextCaseInsensitiveSort) text sorting.
  • Integer (ListViewInt32Sort and ListViewInt64Sort) and floating-point (ListViewDoubleSort) sorting.
  • Date (ListViewDateSort) sorting.
  • Extendable for other specialized user-provided sort orders.
  • Transparently handles null and empty strings.
  • Transparently handles ascending and descending orderings.
  • Displays the sort order image in the column headers.
  • The user can specify the column and sort order at any time.
  • Automatic sorting can be disabled for batch insertion of elements to the list.

Usage

  1. Add a variable of type ListViewSortManager.
    private ListViewSortManager m_sortMgr;
  2. In your form's constructor, after the call to InitializeComponent(), construct the ListViewSortManager passing the list and an array of Type for sorters. There should be one entry in the array for each column in your list. The constructor takes care of hooking into the ListView's ColumnClick event.
    public MainForm()
    {
       //
       // Required for Windows Form Designer support
       //
       InitializeComponent();
    
       m_sortMgr = new ListViewSortManager(m_list, 
          new Type[] {
             typeof(ListViewTextSort),
             typeof(ListViewTextCaseInsensitiveSort),
             typeof(ListViewIntegerSort),
             typeof(ListViewFloatSort),
             typeof(ListViewDateSort)
          }
       );
    }
  3. Voilá! Column sorting has been added to your list.

Extended Usage

If you need to provide a sort ordering that doesn't match the ones provided, you just have to derive a class from ListViewTextSort and, override the OnCompare() method which receives two strings that have to be converted to whatever format that your comparison is based on.

public class ListViewDateSort: ListViewTextSort
{
    public ListViewDateSort(int column, bool ascending):
        base(column, ascending)
    {
    }

    protected override int OnCompare(string lhs, string rhs)
    {
        return DateTime.Parse(lhs).CompareTo(DateTime.Parse(rhs));
    }
}

To Do

  • Investigate alternative, more efficient solutions for sorting that don't require text conversions. Probably, using ListView.Tag and adding overridables to ListViewSortManager.
  • As soon as C# implements generics, implement the comparers as templates.

Updates

Version 1.4 (12/11/04)

  • Added the SortEnabled property to enable/disable automatic sorting of the list's elements. Setting SortEnabled to false before adding a large number of elements to the list will speed up the insertion considerably. (Thanks to Jimmy S. for the suggestion.)
  • Added support for native header sort arrows when using version 6 of the Common Controls library. (Thanks to Arlen Feldman for the suggestion.)

Version 1.3 (02/17/03)

  • ShowHeaderIcon() always left-aligned the column header text regardless of the settings. (Thanks to Jezbo for spotting this).
  • ShowHeaderIcon() now locates the sorting arrow icon on the opposite side of the column header text.

Version 1.2 (11/08/02)

  • The ListViewSortManager's constructor now hooks up to the ColumnClick event making it much easier to use the control. (Thanks to debaser for the suggestion).
  • I forgot to set the transparency for the arrow images. (Thanks to Carlo J. Bos and Cory Smith for spotting this).
  • Made Sort() public again and added an overload that allows to select the column and sort order used. Also added Column and SortOrder properties (Thanks to Cory Smith for the suggestion).

Version 1.1 (11/07/02)

  • Implemented ascending/descending arrow images in column headers. No code changes are necessary to benefit from this.

Version 1.0 (04/22/02)

  • Initial release.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Eddie Velasquez
Software Developer (Senior)
United States United States
No Biography provided

Comments and Discussions

 
GeneralA Big Thank You... PinmemberRoland Zerek28-Jul-08 10:49 
GeneralMulticolumn Sorting available! [modified] PinmemberLuis Alonso Ramos1-Dec-07 10:13 
GeneralProblems with native arrows PinmemberMockum30-Jul-07 10:35 
GeneralRe: Problems with native arrows PinmemberRyan Dunn18-Apr-08 8:02 
QuestionVS2005 bug - arrows don't display PinmemberStoj9-May-07 12:24 
AnswerRe: VS2005 bug - arrows don't display PinmemberAmro Khasawneh19-Jun-07 2:44 
QuestionProblem when resize column width Pinmemberwhiteshark20032-May-07 21:48 
GeneralSorting Text with Numbers [modified] PinmemberDeeJRoss28-Aug-06 11:02 
GeneralRe: Sorting Text with Numbers PinmemberEddie Velasquez28-Aug-06 11:21 
QuestionCopyright? Pinmemberdkintgen2-Aug-06 5:16 
AnswerRe: Copyright? PinmemberEddie Velasquez2-Aug-06 5:21 
Generalnulls crash comparer PinmemberCapt'N Stabbin'17-Jul-06 18:03 
GeneralAuto Filter ListView PinmemberANIL KUMAR SHARMA (INDIA)31-Mar-06 23:15 
AnswerRe: Auto Filter ListView PinmemberCapt'N Stabbin'17-Jul-06 7:13 
GeneralRe: Auto Filter ListView [modified] PinmemberANIL KUMAR SHARMA (INDIA)17-Jul-06 18:48 
QuestionListViewDateSort with date format dd-MM-yyyy doesn't work? Pinmemberid10t30-Mar-06 5:44 
AnswerRe: ListViewDateSort with date format dd-MM-yyyy doesn't work? PinmemberPaula Garden22-Jul-07 16:53 
GeneralGood Solution Pinmembernorm.net14-Mar-06 22:17 
AnswerRe: Good Solution PinmemberCapt'N Stabbin'17-Jul-06 7:18 
GeneralConversion To Vb.net Pinmembereatwork12-Jan-06 6:05 
GeneralRe: Conversion To Vb.net PinmemberDarshon6-Jun-08 18:37 
GeneralRe: Conversion To Vb.net PinmemberMember 40591424-Oct-08 11:34 
GeneralImageList images overwriting arrows PinmemberMilligrant1-Nov-05 7:38 
GeneralColumn without Comparer PinmemberEugene Pankov6-Sep-05 4:32 
GeneralMinor typo in article Pinmemberwout de zeeuw28-Aug-05 10:08 
GeneralForeColor issue Pinmemberbjorn_i3-Aug-05 11:49 
GeneralColumnheader.text disappearing Pinmemberwelberger24-Jul-05 10:51 
QuestionRe: Columnheader.text disappearing Pinmemberheadoo3-Mar-06 6:10 
AnswerRe: Columnheader.text disappearing Pinmemberheadoo6-Mar-06 8:23 
GeneralRe: Columnheader.text disappearing PinmemberRodney Rodríguez21-Jun-06 15:35 
GeneralRe: Columnheader.text disappearing Pinmemberdkintgen23-May-06 7:36 
GeneralRe: Columnheader.text disappearing Pinmemberaldema7-Sep-06 9:36 
Generaltransparant property of listview.items.imagelist not working Pinmembertimbo47523-Jul-05 3:22 
GeneralMultiple Sort PinmemberLuis Alonso Ramos21-Jul-05 14:06 
GeneralRe: Multiple Sort PinmemberEddie Velasquez22-Jul-05 5:07 
GeneralRe: Multiple Sort PinmemberLuis Alonso Ramos22-Jul-05 5:37 
GeneralRe: Multiple Sort PinmemberEddie Velasquez22-Jul-05 6:13 
GeneralRe: Multiple Sort PinmemberLuis Alonso Ramos22-Jul-05 6:33 
GeneralRe: Multiple Sort PinmemberCapt'N Stabbin'17-Jul-06 4:58 
GeneralRe: Multiple Sort PinmemberLuis Alonso Ramos17-Jul-06 6:30 
QuestionWhat about VS2005? PinmemberTheChemist3513-Jun-05 11:11 
AnswerRe: What about VS2005? PinmemberBo Skjoett20-Apr-06 23:35 
GeneralRe: What about VS2005? PinmemberStoj9-May-07 12:23 
GeneralRe: What about VS2005? PinmemberBo Skjoett9-May-07 19:55 
GeneralVery Nice! PinmemberRFID Chris9-Jun-05 10:11 
GeneralRe: Very Nice! PinmemberEddie Velasquez12-Jun-05 7:55 
GeneralCLS Compliant PinmemberPhilip Lee6-Jun-05 21:39 
GeneralRe: CLS Compliant PinmemberEddie Velasquez12-Jun-05 8:00 
GeneralVisual Style problem PinmemberDarthVeda31-May-05 1:09 
GeneralRe: Visual Style problem Pinmemberid10t1-Jun-05 9:53 

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 | Mobile
Web04 | 2.8.141022.2 | Last Updated 13 Dec 2004
Article Copyright 2002 by Eddie Velasquez
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid