WinForms ListBox按下项首字符时循环切换项的问题排查与解决

这个问题我之前也碰到过，根源在于ListBox自带的首字符导航特性和你自定义的输入逻辑冲突了：

WinForms的ListBox默认内置了一个"按首字符快速导航"的功能——当控件获得焦点时，按下字符键，它会自动定位到首字符匹配的项，而且这个行为会优先于我们自己注册的KeyPress事件执行。

你看到的"循环切换曾选中过的匹配项"，是因为这个导航功能会记录最近选中的匹配项集合，每次按下对应字符就会在这些项之间循环跳转。你的代码虽然在处理字符添加，但ListBox已经先完成了选中项的切换，所以就出现了既添加字符又跳项的异常。

核心思路是阻止ListBox执行原生的首字符导航行为，同时完善输入处理逻辑，让功能更符合用户习惯：

1. 在KeyPress事件中设置e.Handled = true;，告诉WinForms我们已经处理了这个按键事件，不需要再执行默认导航行为
2. 增加退格键的处理，允许用户删除输入的字符
3. 过滤控制字符，避免回车、Tab这类键触发不必要的操作

修改后的完整代码如下：

using System.Windows.Forms;

namespace ListboxTest
{
    public partial class ListboxTest : Form
    {
        public ListboxTest()
        {
            InitializeComponent();
            listBox1.Items.Add("");
            listBox1.Items.Add("");
            listBox1.KeyPress += ListBoxKeyPress;
            // 确保只能单选，避免多选状态下的逻辑混乱
            listBox1.SelectionMode = SelectionMode.One;
        }

        private void ListBoxKeyPress(object sender, KeyPressEventArgs e)
        {
            ListBox lbx = (ListBox)sender;

            // 未选中单个项时，直接阻止默认行为
            if (lbx.SelectedIndices.Count != 1)
            {
                e.Handled = true;
                return;
            }

            int selectedIndex = lbx.SelectedIndex;
            string currentValue = lbx.Items[selectedIndex].ToString();

            // 处理退格键：删除最后一个字符
            if (e.KeyChar == (char)Keys.Back)
            {
                if (currentValue.Length > 0)
                {
                    lbx.Items[selectedIndex] = currentValue.Substring(0, currentValue.Length - 1);
                }
                e.Handled = true;
                return;
            }

            // 过滤不可打印的控制字符
            if (char.IsControl(e.KeyChar))
            {
                e.Handled = true;
                return;
            }

            // 添加输入的字符到选中项
            currentValue += e.KeyChar;
            lbx.Items[selectedIndex] = currentValue;

            // 关键：阻止ListBox执行默认的首字符导航
            e.Handled = true;
        }
    }
}

• e.Handled = true;是解决问题的核心：它会终止事件的传递链，让ListBox放弃执行原生的首字符导航逻辑，确保只有你的自定义输入逻辑生效
• 退格键处理是为了让功能更完整，符合用户日常的输入习惯
• 过滤控制字符可以避免意外触发ListBox的其他默认行为（比如回车选中项、Tab切换控件等）

测试一下修改后的代码：不管你之前选中过哪些项，按下字符键只会给当前选中的项添加内容，再也不会自动切换选中项了。

内容的提问来源于stack exchange，提问作者Glasses2C_Sharp