QHelpSearchEngineCore Class

QHelpSearchEngineCoreクラスは、インデックスや検索ドキュメントへのアクセスを提供します。詳細...

Header: #include <QHelpSearchEngineCore>
CMake: find_package(Qt6 REQUIRED COMPONENTS Help)
target_link_libraries(mytarget PRIVATE Qt6::Help)
qmake: QT += help
Since: Qt 6.8
Inherits: 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)

シグナル

詳細説明

サーチエンジンを使用する前に、サーチエンジンのコンストラクタに渡す必要がある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 Extension を参照してください。

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

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

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