WPF自定义LetterBox控件：查找文本填充事件及替换为自定义对象方案

为什么会出现重复输入？ #

你的KeyDown事件处理逻辑中，只自定义了文本添加逻辑，但没有阻止TextBox的默认输入行为。当按下按键时，KeyDown事件触发后，TextBox的内部逻辑仍会将按键对应的字符添加到Text属性中，加上你自己在事件里又添加了一次，就导致了文本重复。

另外，KeyEventArgs.Key直接转成char存在风险：Key枚举是按键的物理标识，和实际输入的字符并不完全对应（比如Key.D1和Key.NumPad1对应同一个字符'1'，但Shift+Key.D1会输入'!'，这时候(char)e.Key得到的还是'D1'对应的字符，不是'!'）。

正确的解决方案 #

1. 替换事件类型，拦截默认行为 #

使用PreviewTextInput事件（WPF）来处理文本输入，它直接提供实际输入的字符，且可以通过e.Handled = true阻止TextBox的默认处理。同时，把static的Letters改成实例属性，避免多个LetterBox实例共享数据。

2. 处理退格/删除键，维护列表同步 #

添加PreviewKeyDown事件处理退格和删除操作，确保Letters列表和TextBox的Text始终同步。

修改后的完整代码 #

internal class LetterBox : TextBox
{
    // 改为实例属性，每个文本框拥有独立的字符列表
    public List<WordElement> Letters { get; set; } = new();

    public LetterBox()
    {
        FontSize = 20;
        // 绑定文本输入事件
        PreviewTextInput += LetterBox_PreviewTextInput;
        // 绑定按键事件处理退格/删除
        PreviewKeyDown += LetterBox_PreviewKeyDown;
    }

    private void LetterBox_PreviewTextInput(object sender, TextCompositionEventArgs e)
    {
        // 处理单个字符输入（粘贴多字符可循环处理）
        if (!string.IsNullOrEmpty(e.Text) && e.Text.Length == 1)
        {
            char inputChar = e.Text[0];
            var wordElement = new WordElement();
            wordElement.SetLetter(inputChar);
            Letters.Add(wordElement);
            
            // 同步文本框内容
            UpdateTextFromLetters();
            // 阻止默认行为，避免重复添加
            e.Handled = true;
        }
    }

    private void LetterBox_PreviewKeyDown(object sender, KeyEventArgs e)
    {
        // 处理退格键：删除最后一个字符
        if (e.Key == Key.Back && Letters.Count > 0)
        {
            Letters.RemoveAt(Letters.Count - 1);
            UpdateTextFromLetters();
            e.Handled = true;
        }
        // 处理删除键（可根据光标位置调整逻辑）
        else if (e.Key == Key.Delete && Letters.Count > 0)
        {
            // 简化处理：删除最后一个字符，实际可根据光标位置删除对应元素
            Letters.RemoveAt(Letters.Count - 1);
            UpdateTextFromLetters();
            e.Handled = true;
        }
    }

    // 统一更新文本的方法，避免重复代码
    private void UpdateTextFromLetters()
    {
        Text = string.Join("", Letters.Select(we => we.Letter));
    }
}

internal class WordElement
{
    public char Letter { get; private set; }
    public Color Color { get; private set; } = Colors.Black;
    public float Size { get; private set; } = 12;
    public bool Bold { get; private set; } = false;
    public bool Italic { get; private set; } = false;
    public bool Underlined { get; private set; } = false;

    public void SetLetter(char letter)
    {
        Letter = letter;
    }

    public void SetColor(Color color)
    {
        Color = color;
    }

    public void SetSize(float size)
    {
        Size = size;
    }

    public void SetBold(bool bold)
    {
        Bold = bold;
    }

    public void SetItalic(bool italic)
    {
        Italic = italic;
    }

    public void SetUnderlined(bool underlined)
    {
        Underlined = underlined;
    }
}

关于文本填充的核心事件/方法 #

在WPF的TextBox中，文本输入的核心处理逻辑是OnTextInput方法。当用户输入字符时，控件会触发这个方法，内部将字符添加到Text属性中。你可以通过两种方式自定义这个过程：

• 使用PreviewTextInput事件：在控件处理输入前触发，适合拦截和自定义输入逻辑。
• 重写OnTextInput方法：直接覆盖控件的默认输入处理逻辑，适合深度自定义。

扩展：如果需要渲染WordElement的样式 #

如果后续需要将WordElement的Color、Size、Bold等样式应用到文本显示上，普通TextBox无法满足（它只能统一设置文本样式）。这时候可以考虑：

• 使用RichTextBox，将每个WordElement转换为带有格式的Run元素，添加到FlowDocument中。
• 自定义绘制控件，在OnRender方法中逐个绘制WordElement，实现自定义样式。

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