Implementing ListView

When to Use This Skill

• Create list views with data binding to collections in Windows Forms applications
• Display item collections with grouping, sorting, and filtering capabilities
• Implement item selection with single or multiple selection modes
• Add checkbox selection for multi-item operations
• Build searchable lists with filtering and sorting
• Create grouped lists with expandable/collapsible groups
• Customize item appearance with templates, styles, and themes
• Support accessibility with UIAutomation and keyboard navigation
• Build data-driven UIs similar to file explorers, contact lists, or product catalogs
• Handle large datasets with optimized view recycling

Component Overview

• Data Binding - Support for IEnumerable data sources with automatic refresh
• Selection Modes - Single, multiple, or none with events
• Checkbox Selection - Multi-select with checkbox, select all, recursive checking
• Grouping - Organize items by property with expandable groups
• Sorting - Ascending/descending sort with custom comparers
• Filtering - Filter items by criteria with live updates
• Item Sizing - Auto-fit or fixed item heights
• Customization - Styles, templates, themes (Office 2016)
• Header/Footer - Custom header and footer views
• Scrollbar Customization - Appearance and behavior
• Localization - Multi-language support
• Accessibility - UIAutomation support for screen readers

Control Structure

SfListView
├── Header View (optional) - Top content area
├── Groups - Collapsible item groups
│   ├── Group Header - Group title and expand/collapse
│   └── Items - Data items in group
├── Items - Flat list of data-bound items
└── Footer View (optional) - Bottom content area

Documentation and Navigation Guide

Getting Started

• Assembly deployment and dependencies
• Adding SfListView via designer and code
• Creating data object classes
• Basic data binding with DataSource
• First list view example

Data Binding

• Binding to IEnumerable data sources
• DataSource property configuration
• DisplayMember and ValueMember
• ObservableCollection for live updates
• Refreshing data programmatically
• Data source change handling

Selection

• SelectionMode (None, One, MultiSimple, MultiExtended)
• SelectedItem and SelectedItems properties
• SelectedIndex and SelectedIndices
• SelectionChanged event
• Programmatic selection
• Selection appearance customization

• CheckBoxMode property
• CheckedItems collection
• CheckedIndices property
• CheckStateChanged event
• Select all functionality
• Recursive checking in grouped lists
• Checkbox appearance customization

Data Operations

• Grouping items by property
• GroupDescriptor configuration
• Sorting items (ascending, descending)
• Custom sort comparers
• Filtering with predicates
• Filter criteria and conditions
• LiveDataUpdateMode for real-time updates

Customization

• Style property customization
• ItemStyle and GroupHeaderStyle
• Theme support (Office 2016, etc.)
• Colors, fonts, and borders
• DrawItem event for custom rendering
• Selection colors and focus indicators

• ItemHeight property
• GroupHeaderHeight property
• AutoFitMode (Height, DynamicHeight)
• Header view customization
• Footer view customization
• Dynamic height calculation

Advanced Features

• Localization and culture support
• UIAutomation for accessibility
• Scrollbar customization
• Performance optimization techniques
• View recycling strategy
• Memory management

Quick Start Example

Basic ListView with Data Binding

using System;
using System.Collections.Generic;
using System.Windows.Forms;
using Syncfusion.WinForms.ListView;

namespace ListViewDemo
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            InitializeListView();
        }
        
        private void InitializeListView()
        {
            // Create and configure ListView
            SfListView listView = new SfListView();
            listView.Dock = DockStyle.Fill;
            listView.Size = new Size(400, 500);
            
            // Set data source
            listView.DataSource = GetCountryData();
            listView.DisplayMember = "CountryName";
            
            // Enable selection
            listView.SelectionMode = Syncfusion.WinForms.ListView.Enums.SelectionMode.One;
            listView.SelectionChanged += ListView_SelectionChanged;
            
            // Add to form
            this.Controls.Add(listView);
        }
        
        private List<CountryInfo> GetCountryData()
        {
            return new List<CountryInfo>
            {
                new CountryInfo { CountryName = "United States", Continent = "North America" },
                new CountryInfo { CountryName = "Canada", Continent = "North America" },
                new CountryInfo { CountryName = "Germany", Continent = "Europe" },
                new CountryInfo { CountryName = "Japan", Continent = "Asia" },
                new CountryInfo { CountryName = "Australia", Continent = "Oceania" }
            };
        }
        
        private void ListView_SelectionChanged(object sender, EventArgs e)
        {
            if (sender is SfListView listView && listView.SelectedItem != null)
            {
                var selected = listView.SelectedItem as CountryInfo;
                MessageBox.Show($"Selected: {selected.CountryName}");
            }
        }
    }
    
    public class CountryInfo
    {
        public string CountryName { get; set; }
        public string Continent { get; set; }
    }
}

Common Patterns

Pattern 1: Grouped and Sorted List

// Create ListView
SfListView listView = new SfListView();
listView.DataSource = GetCountryData();
listView.DisplayMember = "CountryName";

// Add grouping by continent
listView.View.GroupDescriptors.Add(new GroupDescriptor()
{
    PropertyName = "Continent"
});

// Add sorting by country name
listView.View.SortDescriptors.Add(new SortDescriptor()
{
    PropertyName = "CountryName",
    Direction = Syncfusion.Data.ListSortDirection.Ascending
});

Pattern 2: Checkbox Selection with Select All

// Enable checkbox mode
listView.CheckBoxMode = CheckBoxMode.Default;

// Handle checked items changes
listView.CheckStateChanged += (s, e) =>
{
    MessageBox.Show($"Checked items: {listView.CheckedItems.Count}");
};

// Add Select All button
Button selectAllBtn = new Button { Text = "Select All" };
selectAllBtn.Click += (s, e) =>
{
    // Check all items
    for (int i = 0; i < listView.View.Items.Count; i++)
    {
        listView.SetItemCheckState(i, CheckState.Checked);
    }
};

Pattern 3: Filtered and Searchable List

// Add TextBox for search
TextBox searchBox = new TextBox();
searchBox.TextChanged += (s, e) =>
{
    string searchText = searchBox.Text.ToLower();
    
    // Apply filter
    listView.View.Filter = item =>
    {
        if (item is CountryInfo country)
        {
            return country.CountryName.ToLower().Contains(searchText);
        }
        return false;
    };
    
    // Refresh view
    listView.View.RefreshFilter();
};

Pattern 4: Custom Item Styling

// Customize item appearance
listView.Style.ItemStyle.BackColor = Color.White;
listView.Style.ItemStyle.HoverBackColor = Color.LightBlue;
listView.Style.ItemStyle.SelectedItemBackColor = Color.Blue;
listView.Style.ItemStyle.SelectedItemForeColor = Color.White;
listView.Style.ItemStyle.Font = new Font("Segoe UI", 10f);

// Customize group headers
listView.Style.GroupHeaderStyle.BackColor = Color.LightGray;
listView.Style.GroupHeaderStyle.ForeColor = Color.Black;
listView.Style.GroupHeaderStyle.Font = new Font("Segoe UI", 10f, FontStyle.Bold);

Pattern 5: ObservableCollection with Live Updates

using System.Collections.ObjectModel;
using System.ComponentModel;

public class CountryViewModel : INotifyPropertyChanged
{
    private ObservableCollection<CountryInfo> countries;
    
    public ObservableCollection<CountryInfo> Countries
    {
        get { return countries; }
        set
        {
            countries = value;
            OnPropertyChanged(nameof(Countries));
        }
    }
    
    public CountryViewModel()
    {
        Countries = new ObservableCollection<CountryInfo>
        {
            new CountryInfo { CountryName = "USA", Continent = "North America" }
        };
    }
    
    // Add item - ListView updates automatically
    public void AddCountry(CountryInfo country)
    {
        Countries.Add(country);
    }
    
    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

// Bind to ListView
var viewModel = new CountryViewModel();
listView.DataSource = viewModel.Countries;
listView.DisplayMember = "CountryName";

Key Properties

Core Properties

Selection Properties

Checkbox Properties

Appearance Properties

Data Operation Properties

Events

Common Use Cases

1. Contact List Application

2. Product Catalog Browser

3. File Explorer View

4. Task Management Lists

5. Email Client Inbox

6. Customer Order Lists

7. Settings Configuration UI

8. Data Grid Alternative

Related Components

• DataGrid - For tabular data with columns
• TreeView - For hierarchical data structures
• ComboBox - For dropdown selection from list
• CheckedListBox - Simple checkbox list without advanced features

Best Practices

1. Data Binding
   • Use ObservableCollection for automatic UI updates
   • Implement INotifyPropertyChanged for item property changes
   • Set DisplayMember and ValueMember for clarity
2. Performance
   • Enable view recycling (enabled by default)
   • Use AutoFitMode carefully with large datasets
   • Avoid custom DrawItem for simple scenarios
   • Use filtering/grouping instead of recreating data source
3. Selection
   • Handle SelectionChanged event for user actions
   • Use appropriate SelectionMode for use case
   • Clear selection when data source changes if needed
4. Grouping and Filtering
   • Use View.GroupDescriptors for grouping
   • Set View.Filter predicate for filtering
   • Call RefreshFilter() after changing filter criteria
   • Use SortDescriptors for consistent ordering
5. Customization
   • Use Style properties before custom drawing
   • Apply themes for consistent appearance
   • Use ItemStyle and GroupHeaderStyle for basic customization
   • Only use DrawItem for complex custom rendering
6. Accessibility
   • Enable UIAutomation support
   • Provide meaningful DisplayMember values
   • Support keyboard navigation
   • Test with screen readers

Troubleshooting

Items Not Displaying

• Verify DataSource is set and not null
• Check DisplayMember matches property name (case-sensitive)
• Ensure data objects are public properties
• Verify ListView size is not zero

Selection Not Working

• Check SelectionMode is not None
• Verify SelectionChanged event is subscribed
• Ensure items are enabled
• Check if AllowMultiSelection matches SelectionMode

Grouping/Filtering Not Applied

• Call View.RefreshFilter() after filter changes
• Check GroupDescriptor PropertyName is correct
• Verify data property exists and is accessible
• Ensure LiveDataUpdateMode is appropriate

Performance Issues

• Reduce AutoFitMode usage for large lists
• Avoid complex DrawItem logic
• Use view recycling (default behavior)
• Consider virtualization for very large datasets

Checkbox Issues

• Verify CheckBoxMode is not None
• Check RecursiveCheckState setting for grouped lists
• Use CheckStateChanged event, not SelectionChanged
• Ensure CheckedItems vs SelectedItems distinction