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()

completerオブジェクトを破棄する。

[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 のパスを返します。コンプリーターオブジェクトは、これを使用して、基礎となるモデルから補完テキストを取得します。

デフォルトの実装では、リストモデルの場合、項目の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

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

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