Qt QCompleter自动补全怎么实现

在Qt中，QCompleter 是一个用于提供自动补全功能的类。它通常与 QLineEdit、QComboBox 等输入控件结合使用，帮助用户在输入时自动匹配和补全文本。本文将详细介绍如何使用 QCompleter 实现自动补全功能。

1. QCompleter 的基本概念

QCompleter 是 Qt 提供的一个用于自动补全的类。它可以根据用户输入的内容，从一个数据模型中查找匹配的项，并将这些项显示在下拉列表中供用户选择。QCompleter 支持多种数据模型，包括 QStringList、QAbstractItemModel 等。

2. 使用 QCompleter 实现自动补全

2.1 准备工作

首先，确保你已经安装了 Qt 开发环境，并且创建了一个基本的 Qt 项目。我们将在一个简单的 QLineEdit 控件中实现自动补全功能。

2.2 创建 QLineEdit 和 QCompleter

在 Qt 中，QLineEdit 是一个常用的单行文本输入控件。我们可以通过将 QCompleter 与 QLineEdit 结合，实现自动补全功能。

#include <QApplication>
#include <QLineEdit>
#include <QCompleter>
#include <QStringList>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 创建一个 QLineEdit 控件
    QLineEdit lineEdit;

    // 创建一个字符串列表作为补全数据源
    QStringList wordList;
    wordList << "apple" << "banana" << "cherry" << "date" << "elderberry";

    // 创建一个 QCompleter 对象，并将字符串列表作为数据源
    QCompleter *completer = new QCompleter(wordList, &lineEdit);
    completer->setCaseSensitivity(Qt::CaseInsensitive); // 设置不区分大小写

    // 将 QCompleter 与 QLineEdit 关联
    lineEdit.setCompleter(completer);

    // 显示 QLineEdit
    lineEdit.show();

    return app.exec();
}

2.3 运行效果

运行上述代码后，你将看到一个 QLineEdit 控件。当你在其中输入文本时，QCompleter 会根据输入的内容自动匹配并显示可能的补全项。例如，输入 “a” 时，下拉列表会显示 “apple” 和 “banana”。

2.4 自定义补全行为

QCompleter 提供了多种选项来自定义补全行为。以下是一些常用的设置：

• 设置补全模式：可以通过 setCompletionMode 方法设置补全模式。常见的模式包括 QCompleter::PopupCompletion（弹出式补全）和 QCompleter::InlineCompletion（内联补全）。

  completer->setCompletionMode(QCompleter::PopupCompletion);
  

• 设置补全大小：可以通过 setMaxVisibleItems 方法设置下拉列表中显示的最大项数。

  completer->setMaxVisibleItems(5);
  

• 设置补全延迟：可以通过 setCompletionRole 方法设置补全延迟时间（以毫秒为单位）。

  completer->setCompletionRole(500); // 500 毫秒延迟
  

2.5 使用自定义数据模型

除了使用 QStringList 作为数据源外，QCompleter 还支持使用 QAbstractItemModel 作为数据源。这对于需要从数据库或其他复杂数据源中获取补全项的场景非常有用。

#include <QStandardItemModel>

// 创建一个标准项模型
QStandardItemModel *model = new QStandardItemModel(&lineEdit);

// 添加数据项
QStandardItem *item1 = new QStandardItem("apple");
QStandardItem *item2 = new QStandardItem("banana");
QStandardItem *item3 = new QStandardItem("cherry");

model->appendRow(item1);
model->appendRow(item2);
model->appendRow(item3);

// 创建一个 QCompleter 对象，并将模型作为数据源
QCompleter *completer = new QCompleter(model, &lineEdit);

// 将 QCompleter 与 QLineEdit 关联
lineEdit.setCompleter(completer);

2.6 处理补全事件

在某些情况下，你可能需要在用户选择补全项时执行一些操作。可以通过连接 QCompleter 的信号和槽来实现。

QObject::connect(completer, QOverload<const QString &>::of(&QCompleter::activated),
            [](const QString &text) {
                qDebug() << "Selected completion:" << text;
            });

3. 总结

通过 QCompleter，我们可以轻松地在 Qt 应用程序中实现自动补全功能。无论是简单的字符串列表还是复杂的数据模型，QCompleter 都提供了灵活的接口来满足不同的需求。希望本文能帮助你理解并掌握如何在 Qt 中使用 QCompleter 实现自动补全功能。

参考文档： - Qt Documentation: QCompleter - Qt Documentation: QLineEdit - Qt Documentation: QAbstractItemModel