WPF中实现类Excel的TextBox AutoComplete功能需求

嘿，我完全懂你想要的那种Excel式自动补全效果——输入开头字符就自动带出完整匹配项，而且补全的部分还会被高亮选中，方便你一键确认或者直接修改。刚好我之前做过类似的实现，给你拆解下具体怎么做：

• 监听TextBox的TextChanged事件，每次输入内容变化时，从候选列表（比如你说的同一列已有内容）里找以当前输入开头的匹配项
• 找到匹配项后，直接替换TextBox的文本为完整匹配内容，然后选中补全的那部分（也就是当前输入长度之后的内容）
• 处理回车键事件，按下回车时取消选中状态，同时把当前输入的内容加入候选列表，方便后续其他TextBox复用补全

第一步：XAML里配置TextBox #

先给TextBox绑定需要的事件：

<TextBox 
    x:Name="AutoCompleteTextBox" 
    TextChanged="AutoCompleteTextBox_TextChanged" 
    KeyDown="AutoCompleteTextBox_KeyDown"
    Width="200" Height="30"/>

第二步：后台逻辑实现 #

首先定义一个候选列表，用来存储同一列的已有内容（你可以根据实际场景从数据源里获取，比如DataGrid的列数据）：

// 候选补全列表，模拟同一列的已有内容
private List<string> _completionItems = new List<string> { "Medicine", "Milk", "Monitor", "Apple" };

然后处理TextChanged事件，实现补全和选中逻辑：

private void AutoCompleteTextBox_TextChanged(object sender, TextChangedEventArgs e)
{
    var textBox = sender as TextBox;
    if (textBox == null || string.IsNullOrWhiteSpace(textBox.Text))
        return;

    var currentInput = textBox.Text.Trim();
    // 查找第一个以当前输入开头的匹配项（忽略大小写）
    var matchedItem = _completionItems.FirstOrDefault(item => 
        item.StartsWith(currentInput, StringComparison.OrdinalIgnoreCase));

    if (matchedItem != null)
    {
        // 替换文本为匹配项
        textBox.Text = matchedItem;
        // 选中补全的部分：从当前输入的长度开始，到匹配项末尾
        textBox.SelectionStart = currentInput.Length;
        textBox.SelectionLength = matchedItem.Length - currentInput.Length;
    }
}

接下来处理KeyDown事件，实现回车确认和输入替换选中内容的逻辑：

private void AutoCompleteTextBox_KeyDown(object sender, KeyEventArgs e)
{
    var textBox = sender as TextBox;
    if (textBox == null)
        return;

    // 按下回车键：取消选中，光标移到末尾，同时把当前内容加入候选列表
    if (e.Key == Key.Enter)
    {
        textBox.SelectionLength = 0;
        textBox.SelectionStart = textBox.Text.Length;
        
        // 避免重复添加相同内容
        if (!_completionItems.Contains(textBox.Text, StringComparer.OrdinalIgnoreCase))
        {
            _completionItems.Add(textBox.Text);
        }
        e.Handled = true;
    }
    // 输入普通字符时：如果当前有选中内容，直接替换选中部分（和Excel行为一致）
    else if ((e.Key >= Key.A && e.Key <= Key.Z) || (e.Key >= Key.D0 && e.Key <= Key.D9))
    {
        if (textBox.SelectionLength > 0)
        {
            // 转换Key为对应的字符
            var inputChar = e.Key.ToString().ToLower()[0];
            // 替换选中部分为输入的字符
            textBox.Text = textBox.Text.Remove(textBox.SelectionStart, textBox.SelectionLength)
                                      .Insert(textBox.SelectionStart, inputChar.ToString());
            // 光标移到输入字符的下一位
            textBox.SelectionStart = textBox.SelectionStart + 1;
            textBox.SelectionLength = 0;
            e.Handled = true;
        }
    }
}

• 候选列表动态更新：如果你的场景是DataGrid列，可以在单元格失去焦点时，把单元格内容同步到_completionItems里，保证补全数据是最新的
• 大小写保持：上面的代码是忽略大小写匹配，但补全后会保留原匹配项的大小写（比如原项是Medicine，输入m也会补全成Medicine），如果需要保持用户输入的大小写，可以在替换文本时做调整
• 避免重复触发：如果担心设置textBox.Text时重复触发TextChanged事件，可以加一个标记位，比如_isUpdatingText，在替换文本时设为true，事件开头判断如果是true就跳过，替换完再设为false

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