このページでは

QHelpSearchEngineCore Class

QHelpSearchEngineCore クラスは、ドキュメントのインデックス作成および検索機能へのアクセスを提供します。詳細...

ヘッダー: #include <QHelpSearchEngineCore>
CMake: find_package(Qt6 REQUIRED COMPONENTS Help)
target_link_libraries(mytarget PRIVATE Qt6::Help)
qmake: QT += help
以下のように: Qt 6.8
継承元: QObject

パブリック関数

QHelpSearchEngineCore(QHelpEngineCore *helpEngine, QObject *parent = nullptr)
virtual ~QHelpSearchEngineCore() override
QString searchInput() const
int searchResultCount() const
QList<QHelpSearchResult> searchResults(int start, int end) const

パブリックスロット

void cancelIndexing()
void cancelSearching()
void reindexDocumentation()
void search(const QString &searchInput)

シグナル

詳細な説明

検索エンジンを使用するには、少なくとも 1 つの `QHelpEngineCore ` オブジェクトをインスタンス化し、それを検索エンジンのコンストラクタに渡す必要があります。これは、ドキュメントのインデックス作成を開始できるタイミングを知るために、検索エンジンをヘルプエンジンの `setupFinished()` シグナルに接続する必要があるためです。

インデックス作成プロセスが開始されると、indexingStarted() シグナルが発信され、インデックス作成プロセスの終了時にはindexingFinished() が発信されます。インデックス作成を停止するには、cancelIndexing() を呼び出します。

インデックス作成プロセスが完了すると、検索エンジンはsearch() 関数を使用して、指定された用語についてインデックス内を検索できるようになります。検索入力が検索エンジンに渡されると、searchingStarted() シグナルが発信されます。検索が終了すると、searchingFinished() シグナルが発信されます。検索プロセスは、cancelSearching() を呼び出すことで停止できます。

検索が成功した場合、検索結果の件数を引数としてsearchingFinished()が呼び出され、検索エンジンから検索結果が取得されます。範囲を指定してsearchResults()関数を呼び出すと、その範囲内のQHelpSearchResult オブジェクトのリストが返されます。結果には、ドキュメントのタイトルとURLに加え、検索入力と最も一致するドキュメントの抜粋が含まれます。

メンバ関数のドキュメント

[explicit] QHelpSearchEngineCore::QHelpSearchEngineCore(QHelpEngineCore *helpEngine, QObject *parent = nullptr)

指定されたparent を使用して、新しい検索エンジンを構築します。この検索エンジンは、指定されたhelpEngine を使用して、インデックス登録が必要なドキュメントにアクセスします。QHelpEngineCore のsetupFinished()シグナルは、QHelpSearchEngineCoreのインデックス登録関数に自動的に接続されるため、このシグナルが発信された後に新しいドキュメントがインデックス登録されます。

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

検索エンジンを破壊します。

[slot] void QHelpSearchEngineCore::cancelIndexing()

インデックス作成プロセスを停止します。

[slot] void QHelpSearchEngineCore::cancelSearching()

検索処理を停止します。

[signal] void QHelpSearchEngineCore::indexingFinished()

この信号は、インデックス作成処理が完了したときに送信されます。

[signal] void QHelpSearchEngineCore::indexingStarted()

このシグナルは、インデックス作成プロセスが開始されたときに送信されます。

[slot] void QHelpSearchEngineCore::reindexDocumentation()

検索エンジンに対し、すべてのドキュメントファイルの再インデックスを強制します。

指定された検索フレーズ「searchInput 」を使用して検索処理を開始します。

検索フレーズは複数の単語で構成される場合があります。デフォルトでは、検索エンジンは指定されたすべての単語を含む文書のリストを返します。検索フレーズには、論理演算子「AND」、「OR」、「NOT」を任意に組み合わせて使用できます。演算子はすべて大文字で記述する必要があります。大文字でない場合、検索フレーズの一部として扱われます。

単語をグループ化するために二重引用符を使用した場合、検索エンジンは引用符で囲まれたフレーズと完全に一致するものを検索します。

テキストクエリの構文に関する詳細については、『SQLite FTS5 拡張機能』を参照してください。

QString QHelpSearchEngineCore::searchInput() const

最後に検索されたフレーズを返します。

int QHelpSearchEngineCore::searchResultCount() const

検索エンジンが見つけた結果の数を返します。

QList<QHelpSearchResult> QHelpSearchEngineCore::searchResults(int start, int end) const

start で指定されたインデックスから、end で指定されたインデックスまでの範囲内の検索結果のリストを返します。

[signal] void QHelpSearchEngineCore::searchingFinished()

この信号は、検索処理が完了したときに送信されます。

[signal] void QHelpSearchEngineCore::searchingStarted()

このシグナルは、検索プロセスが開始されたときに発信されます。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.