QHelpSearchEngine Class
QHelpSearchEngineクラスは、全文検索やドキュメントの索引付けや検索を統合するために再利用可能なウィジェットへのアクセスを提供します。さらに...
ヘッダ | #include <QHelpSearchEngine> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Help) target_link_libraries(mytarget PRIVATE Qt6::Help) |
qmake: | QT += help |
継承: | 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()
このシグナルは、検索プロセスが開始されたときに発せられる。
© 2025 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.