QHelpSearchEngine Class

QHelpSearchEngineクラスは、全文検索やドキュメントの索引付けや検索を統合するために再利用可能なウィジェットへのアクセスを提供します。詳細...

Header: #include <QHelpSearchEngine>
CMake: find_package(Qt6 REQUIRED COMPONENTS Help)
target_link_libraries(mytarget PRIVATE Qt6::Help)
qmake: QT += help
Inherits: QObject

パブリック関数

QHelpSearchEngine(QHelpEngineCore *helpEngine, QObject *parent = nullptr)
virtual ~QHelpSearchEngine()
QHelpSearchQueryWidget *queryWidget()
QHelpSearchResultWidget *resultWidget()
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)

シグナル

void indexingFinished()
void indexingStarted()
void searchingFinished(int searchResultCount)
void searchingStarted()

詳細説明

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

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

インデックス作成処理が終了すると、search()関数を使用して、指定した用語をインデックスから検索することができます。検索入力が検索エンジンに渡されると、searchingStarted() シグナルが発せられる。検索が終了すると、searchingFinished() シグナルが発せられる。cancelSearching() を呼び出すと、検索処理を停止できる。

検索に成功すると、検索結果カウントとともにsearchingFinished() が呼び出され、検索エンジンから検索結果が取得される。searchResults() 関数に範囲を指定して呼び出すと、その範囲内にあるQHelpSearchResult オブジェクトのリストが返される。結果は、ドキュメントのタイトルとURL、そして検索入力に最もマッチしたドキュメントのスニペットから構成されます。

指定された検索結果を表示するには、QHelpSearchResultWidget を使用するか、より高度な機能が必要な場合は独自のものを構築してください。QHelpSearchResultWidget すべての接続はウィジェット自身によって確立されるので、使用中の検索エンジンからウィジェットを取得する必要があります。

メンバ関数ドキュメント

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

与えられたparent で新しい検索エンジンを構築する。検索エンジンは、インデックスが必要なドキュメントにアクセスするために、与えられたhelpEngine を使用します。QHelpEngine'のsetupFinished()シグナルは、自動的にQHelpSearchEngineのインデックス作成関数に接続されるので、シグナルが発せられた後、新しいドキュメントがインデックス作成されます。

[virtual noexcept] QHelpSearchEngine::~QHelpSearchEngine()

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

[slot] void QHelpSearchEngine::cancelIndexing()

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

[slot] void QHelpSearchEngine::cancelSearching()

検索処理を停止します。

[signal] void QHelpSearchEngine::indexingFinished()

このシグナルは、インデックス作成処理が完了したときに発せられる。

[signal] void QHelpSearchEngine::indexingStarted()

インデックス作成処理が開始されると、このシグナルが発せられる。

QHelpSearchQueryWidget *QHelpSearchEngine::queryWidget()

入力ウィジェットとして使用するウィジェットを返します。検索エンジンの設定に応じて、多かれ少なかれサブウィジェットを持つ異なるウィジェットを取得します。

[slot] void QHelpSearchEngine::reindexDocumentation()

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

QHelpSearchResultWidget *QHelpSearchEngine::resultWidget()

検索結果を保持し表示できるウィジェットを返します。

[slot] void QHelpSearchEngine::search(const QString &searchInput)

指定された検索フレーズsearchInput を使用して検索プロセスを開始します。

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

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

テキストクエリの構文についての詳細はSQLite FTS5 Extension を参照してください。

QString QHelpSearchEngine::searchInput() const

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

int QHelpSearchEngine::searchResultCount() const

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

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

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

[signal] void QHelpSearchEngine::searchingFinished(int searchResultCount)

このシグナルは検索処理が完了したときに発せられる。検索結果のカウントはsearchResultCount に格納される。

[signal] void QHelpSearchEngine::searchingStarted()

このシグナルは、検索処理が開始されたときに発せられます。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。