QCompleter Class

メンバ関数ドキュメント

QCompleter::QCompleter(QObject *parent = nullptr)

与えられたparent を持つコンプレータオブジェクトを構築します。

QCompleter::QCompleter(QAbstractItemModel *model, QObject *parent = nullptr)

指定されたmodel からの補完を提供する、指定されたparent を持つコンプリーターオブジェクトを構築します。

QCompleter::QCompleter(const QStringList &list, QObject *parent = nullptr)

指定されたlist を補完候補のソースとして使用する、指定されたparent を持つ QCompleter オブジェクトを構築します。

[override virtual noexcept] QCompleter::~QCompleter()

コンプリーターオブジェクトを破棄します。

[signal] void QCompleter::activated(const QModelIndex &index)

このシグナルは、popup() 内の項目がユーザーによってアクティブにされたときに送信されます。(クリックするかリターンを押すことによって)。completionModel （）内のアイテムのindex 。

注意：このクラスでは、シグナルactivatedはオーバーロードされています。関数ポインタ構文を使用してこのシグナルに接続するために、Qt はこの例に示すように関数ポインタを取得する便利なヘルパーを提供します：

connect(completer, QOverload<const QModelIndex &>::of(&QCompleter::activated),
    [=](const QModelIndex &index){ /* ... */ });

[signal] void QCompleter::activated(const QString &text)

このシグナルは、popup() 内のアイテムがユーザーによって（クリックしたりリターンを押したりして）アクティブにされると送られます。アイテムのtext 。

注意：このクラスでは、シグナルactivatedはオーバーロードされています。関数ポインタ構文を使用してこのシグナルに接続するために、Qtはこの例に示すように関数ポインタを取得する便利なヘルパーを提供しています：

connect(completer, QOverload<const QString &>::of(&QCompleter::activated),
    [=](const QString &text){ /* ... */ });

[slot] void QCompleter::complete(const QRect &rect = QRect())

QCompleter::PopupCompletion および QCompletion::UnfilteredPopupCompletion モードでは、この関数を呼び出すと、現在の完了を表示するポップアップが表示されます。デフォルトでは、rect が指定されていない場合、ポップアップはwidget() の下部に表示されます。rect が指定された場合、ポップアップは矩形の左端に表示されます。

QCompleter::InlineCompletion モードの場合、highlighted() シグナルが現在の完了とともに発生する。

int QCompleter::completionCount() const

現在のプレフィックスの完了数を返します。項目数の多いソートされていないモデルの場合、これは高価になる可能性があります。setCurrentRow() やcurrentCompletion() を使用して、すべての補完を繰り返し処理します。

QAbstractItemModel *QCompleter::completionModel() const

補完モデルを返します。補完モデルは読み込み専用のリストモデルで、 現在の補完プレフィックスにマッチする可能性のあるものをすべて含みます。補完モデルは、現在の補完を反映するように自動的に更新されます。

completionPrefix およびmodel()も参照してください 。

QString QCompleter::currentCompletion() const

現在の補完文字列を返します。これにはcompletionPrefix が含まれます。setCurrentRow() と一緒に使用すると、すべてのマッチを繰り返し処理することができます。

setCurrentRow() およびcurrentIndex()も参照 。

QModelIndex QCompleter::currentIndex() const

completionModel() の現在の補完候補のモデルインデックスを返します。

setCurrentRow()、currentCompletion() およびmodel() も参照 。

int QCompleter::currentRow() const

現在の行を返します。

setCurrentRow()も参照 ください。

[override virtual protected] bool QCompleter::event(QEvent *ev)

再インプリメント：QObject::event(QEvent *e)。

[override virtual protected] bool QCompleter::eventFilter(QObject *o, QEvent *e)

再リンプルメント：QObject::eventFilter(QObject *watched, QEvent *event)。

[signal] void QCompleter::highlighted(const QModelIndex &index)

このシグナルは、popup() 内のアイテムがユーザによってハイライトされたときに送られます。また、completionMode() がQCompleter::InlineCompletion に設定された状態でcomplete() が呼び出された場合にも送られる。completionModel() 内のアイテムのindex が指定された場合にも送られる。

注：シグナルhighlightedは、このクラスでオーバーロードされています。関数ポインタ構文を使用してこのシグナルに接続するために、Qt はこの例に示すように関数ポインタを取得する便利なヘルパーを提供します：

connect(completer, QOverload<const QModelIndex &>::of(&QCompleter::highlighted),
    [=](const QModelIndex &index){ /* ... */ });

[signal] void QCompleter::highlighted(const QString &text)

このシグナルは、popup() 内のアイテムがユーザーによってハイライトされたときに送られます。このシグナルは、completionMode() がQCompleter::InlineCompletion に設定された状態でcomplete() が呼び出された場合にも送られます。アイテムのtext が与えられます。

注：このクラスでは、シグナルhighlightedはオーバーロードされています。関数ポインタ構文を使用してこのシグナルに接続するために、Qt は、この例で示されているように、関数ポインタを取得するための便利なヘルパーを提供します：

connect(completer, QOverload<const QString &>::of(&QCompleter::highlighted),
    [=](const QString &text){ /* ... */ });

QAbstractItemModel *QCompleter::model() const

補完文字列を提供するモデルを返します。

setModel() およびcompletionModel()も参照してください 。

[virtual] QString QCompleter::pathFromIndex(const QModelIndex &index) const

与えられたindex のパスを返します。completerオブジェクトは、これを使用して、基礎となるモデルから補完テキストを取得します。

デフォルトの実装では、リスト・モデルの場合、項目のedit role を返します。モデルがQFileSystemModel の場合は、絶対ファイルパスを返します。

splitPath()も参照してください 。

QAbstractItemView *QCompleter::popup() const

補完の表示に使用するポップアップを返します。

setPopup() も参照して ください。

bool QCompleter::setCurrentRow(int row)

現在の行を指定されたrow に設定します。成功した場合はtrue を返し、失敗した場合はfalse を返します。

この関数は、currentCompletion() と一緒に使用して、すべての補完候補を繰り返し処理することもできます。

currentRow()、currentCompletion() およびcompletionCount()も参照 。

void QCompleter::setModel(QAbstractItemModel *model)

補完を提供するモデルをmodel に設定します。model は、リスト・モデルでもツリー・モデルでもかまいません。既に設定されているモデルがQCompleter を親に持つ場合、そのモデルは削除されます。

便宜上、model がQFileSystemModel の場合、QCompleter はそのcaseSensitivity を Windows ではQt::CaseInsensitive に、その他のプラットフォームではQt::CaseSensitive に切り替えます。

completionModel()、modelSorting 、Handling Tree Modelsも参照のこと 。

void QCompleter::setPopup(QAbstractItemView *popup)

補完の表示に使用されるポップアップをpopup に設定します。QCompleter がビューの所有権を持ちます。

completionMode() がQCompleter::PopupCompletion またはQCompleter::UnfilteredPopupCompletion に設定されると、QListView が自動的に作成されます。 デフォルトのポップアップはcompletionColumn() を表示します。

ビューの設定が変更される前にこの関数が呼び出されるようにしてください。これは、ビューのプロパティがビューにモデルが設定されていることを必要とする場合があるためです（例えば、ビューの列を非表示にするには、ビューにモデルが設定されている必要があります）。

popup()も参照してください 。

void QCompleter::setWidget(QWidget *widget)

補完が提供されるウィジェットをwidget に設定します。この関数は、QLineEdit::setCompleter() を使用してQLineEdit にQCompleter が設定されたとき、またはQComboBox::setCompleter() を使用してQComboBox に が設定されたときに自動的に呼び出されます。カスタムウィジェットに補完を提供する場合は、ウィジェットを明示的に設定する必要があります。

widget()、setModel()、setPopup()も参照 。

[virtual] QStringList QCompleter::splitPath(const QString &path) const

指定されたpath を、model() の各レベルでのマッチに使用する文字列に分割します。

splitPath() の既定の実装では、sourceModel() がQFileSystemModel の場合、QDir::separator() に基づいてファイル・システム・パスを分割します。

リスト・モデルと共に使用すると、返されるリストの最初の項目がマッチングに使用されます。

pathFromIndex() およびHandling Tree Modelsも参照してください 。

QWidget *QCompleter::widget() const

completer オブジェクトが補完を提供しているウィジェットを返します。

setWidget()も参照して ください。