Qt?QCompleter自動補全怎么實現

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