KryptonListBox ✓ LCode 已集成 Toolkit

简介

KryptonListBox 是增强型列表框控件，替代标准 System.Windows.Forms.ListBox。它以 Krypton 主题风格渲染列表项的选中、悬停状态，支持单选/多选、项高度自定义、水平滚动条以及数据绑定，适合展示一组可选文本项。

常用属性

快速上手

基本用法

using Krypton.Toolkit;

var listBox = new KryptonListBox();
listBox.Location = new Point(16, 16);
listBox.Size = new Size(200, 160);

// 添加列表项
listBox.Items.Add("北京");
listBox.Items.Add("上海");
listBox.Items.Add("广州");
listBox.Items.Add("深圳");

// 默认选中第一项
listBox.SelectedIndex = 0;

// 选中项改变事件
listBox.SelectedIndexChanged += (s, e) =>
    MessageBox.Show($"选中：{listBox.SelectedItem}");

this.Controls.Add(listBox);

多选模式

listBox.SelectionMode = SelectionMode.MultiExtended;

// 遍历所有选中项
foreach (int idx in listBox.SelectedIndices)
    Console.WriteLine(listBox.Items[idx]);

进阶用法

数据绑定

var cities = new List<City>
{
    new City { Id = 1, Name = "北京" },
    new City { Id = 2, Name = "上海" },
};

listBox.DataSource = cities;
listBox.DisplayMember = "Name";   // 显示名称
listBox.ValueMember = "Id";       // 取值 Id

listBox.SelectedValueChanged += (s, e) =>
    Console.WriteLine($"选中城市 Id：{listBox.SelectedValue}");

自定义选中项外观

// 选中项背景使用主题绿
listBox.StateCommon.Item.Back.Color1 = Color.FromArgb(204, 251, 241);
listBox.StateCommon.Item.Content.ShortText.Color1 = Color.FromArgb(15, 118, 110);

// 悬停项背景
listBox.StateTracking.Item.Back.Color1 = Color.FromArgb(240, 253, 244);

对应示例项目

📁 Source/Krypton Toolkit Examples/KryptonListBox Examples/

包含：单选/多选演示、数据绑定、项外观自定义。

相关控件