Click here to Skip to main content
13,147,044 members (64,215 online)
Click here to Skip to main content
Add your own
alternative version

Stats

311K views
1.7K downloads
97 bookmarked
Posted 21 Apr 2002

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, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

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

You may also be interested in...

Pro

Comments and Discussions

 
GeneralA Big Thank You... Pin
Roland Zerek28-Jul-08 10:49
memberRoland Zerek28-Jul-08 10:49 
GeneralMulticolumn Sorting available! [modified] Pin
Luis Alonso Ramos1-Dec-07 10:13
memberLuis Alonso Ramos1-Dec-07 10:13 
GeneralProblems with native arrows Pin
Mockum30-Jul-07 10:35
memberMockum30-Jul-07 10:35 
GeneralRe: Problems with native arrows Pin
Ryan Dunn18-Apr-08 8:02
memberRyan Dunn18-Apr-08 8:02 
QuestionVS2005 bug - arrows don't display Pin
Stoj9-May-07 12:24
memberStoj9-May-07 12:24 
AnswerRe: VS2005 bug - arrows don't display Pin
Amro Khasawneh19-Jun-07 2:44
memberAmro Khasawneh19-Jun-07 2:44 
QuestionProblem when resize column width Pin
whiteshark20032-May-07 21:48
memberwhiteshark20032-May-07 21:48 
GeneralSorting Text with Numbers [modified] Pin
DeeJRoss28-Aug-06 11:02
memberDeeJRoss28-Aug-06 11:02 
GeneralRe: Sorting Text with Numbers Pin
Eddie Velasquez28-Aug-06 11:21
memberEddie Velasquez28-Aug-06 11:21 
QuestionCopyright? Pin
dkintgen2-Aug-06 5:16
memberdkintgen2-Aug-06 5:16 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.170915.1 | Last Updated 13 Dec 2004
Article Copyright 2002 by Eddie Velasquez
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid