如何将WPF TextBox转换为宿主Windows Forms TextBox以实现多行自动补全？

阿华AIGC实验室

2026-5-21

如何在WPF中宿主Windows Forms多行TextBox实现自动补全功能？

我来帮你搞定这个问题！既然WPF原生TextBox搞不定自动补全，又找不到合适的第三方组件，那用WinForms的TextBox来实现绝对是个靠谱的路子。下面一步步教你把现有的WPF TextBox转换成能宿主WinForms组件的结构，还能保留你的绑定和交互逻辑：

1. 先添加必要的程序集引用

首先得给项目加两个核心引用：

System.Windows.Forms：WinForms控件的核心库
WindowsFormsIntegration：WPF和WinForms互操作的桥梁

在Visual Studio里右键项目→添加→引用，找到这两个库勾选即可。

2. 在XAML中引入命名空间

在你的Window/UserControl根节点里添加两个命名空间：

xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"
xmlns:wfi="clr-namespace:System.Windows.Forms.Integration;assembly=WindowsFormsIntegration"
<!-- 还要加系统字符串的命名空间（如果要在XAML里写补全候选词） -->
xmlns:sys="clr-namespace:System;assembly=mscorlib"

3. 替换原有WPF TextBox为WindowsFormsHost

把你原来的WPF TextBox替换成WindowsFormsHost，里面嵌套WinForms的TextBox，同时适配你的绑定和样式需求：

<!-- 先在资源里声明颜色转换器（因为WPF的Brush和WinForms的Color不兼容） -->
<Window.Resources>
    <local:ColorToWinFormsColorConverter x:Key="ColorToWinFormsColorConverter" />
</Window.Resources>

<!-- 替换后的宿主控件 -->
<wfi:WindowsFormsHost>
    <wf:TextBox x:Name="WinFormsMultiLineTextBox" 
                Multiline="True"
                AcceptsReturn="True"
                Text="{Binding MyViewModel.MyText, Mode=TwoWay}"
                BackColor="{Binding MyViewModel.MyTextBackgroundColor, Converter={StaticResource ColorToWinFormsColorConverter}}">
        <!-- 配置自动补全 -->
        <wf:TextBox.AutoCompleteCustomSource>
            <wf:AutoCompleteStringCollection>
                <!-- 这里可以直接写静态候选词，或者后续通过后台绑定动态集合 -->
                <sys:String>用户反馈</sys:String>
                <sys:String>系统日志</sys:String>
                <sys:String>调试信息</sys:String>
            </wf:AutoCompleteStringCollection>
        </wf:TextBox.AutoCompleteCustomSource>
        <wf:TextBox.AutoCompleteMode>SuggestAppend</wf:TextBox.AutoCompleteMode>
        <wf:TextBox.AutoCompleteSource>CustomSource</wf:TextBox.AutoCompleteSource>
    </wf:TextBox>
</wfi:WindowsFormsHost>

4. 关键细节处理

颜色转换器实现

因为WPF的SolidColorBrush和WinForms的Color类型不匹配，需要写一个转换器来转换：

public class ColorToWinFormsColorConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is SolidColorBrush brush)
        {
            return System.Drawing.Color.FromArgb(
                brush.Color.A,
                brush.Color.R,
                brush.Color.G,
                brush.Color.B);
        }
        return System.Drawing.Color.White;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is System.Drawing.Color color)
        {
            return new SolidColorBrush(System.Windows.Media.Color.FromArgb(
                color.A,
                color.R,
                color.G,
                color.B));
        }
        return Brushes.White;
    }
}

原有Style和交互触发器的适配

WinForms控件不支持WPF的Style，如果你的EventTextBox里有事件处理或视觉样式，需要把逻辑转到WinForms对应的属性/事件上（比如用WinForms的Font、Padding调整样式，用后台代码绑定事件）。
原有的Interaction.Triggers无法直接作用于WinForms控件，你可以把触发器逻辑移到后台代码，用WinForms的原生事件实现相同功能。

动态补全候选词

如果你的补全列表是动态从ViewModel获取的，可以在后台同步集合：

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    var viewModel = DataContext as MyViewModel;
    if (viewModel == null || WinFormsMultiLineTextBox == null) return;

    // 初始化补全列表
    foreach (var item in viewModel.AutoCompleteItems)
    {
        WinFormsMultiLineTextBox.AutoCompleteCustomSource.Add(item);
    }

    // 监听集合变化，动态更新补全列表
    if (viewModel.AutoCompleteItems is INotifyCollectionChanged collection)
    {
        collection.CollectionChanged += (s, args) =>
        {
            if (args.NewItems != null)
            {
                foreach (var item in args.NewItems)
                {
                    WinFormsMultiLineTextBox.AutoCompleteCustomSource.Add(item.ToString());
                }
            }
            if (args.OldItems != null)
            {
                foreach (var item in args.OldItems)
                {
                    WinFormsMultiLineTextBox.AutoCompleteCustomSource.Remove(item.ToString());
                }
            }
        };
    }
}