QHelpSearchEngineCore Class
Die Klasse QHelpSearchEngineCore ermöglicht den Zugriff auf die Index- und Suchdokumentation. Mehr...
| Kopfzeile: | #include <QHelpSearchEngineCore> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Help)target_link_libraries(mytarget PRIVATE Qt6::Help) |
| qmake: | QT += help |
| Seit: | Qt 6.8 |
| Vererbt: | QObject |
Öffentliche Funktionen
| QHelpSearchEngineCore(QHelpEngineCore *helpEngine, QObject *parent = nullptr) | |
| virtual | ~QHelpSearchEngineCore() override |
| QString | searchInput() const |
| int | searchResultCount() const |
| QList<QHelpSearchResult> | searchResults(int start, int end) const |
Öffentliche Slots
| void | cancelIndexing() |
| void | cancelSearching() |
| void | reindexDocumentation() |
| void | search(const QString &searchInput) |
Signale
| void | indexingFinished() |
| void | indexingStarted() |
| void | searchingFinished() |
| void | searchingStarted() |
Detaillierte Beschreibung
Bevor die Suchmaschine verwendet werden kann, muss mindestens ein QHelpEngineCore Objekt instanziiert werden, das an den Konstruktor der Suchmaschine übergeben werden muss. Dies ist erforderlich, da die Suchmaschine mit dem Signal setupFinished() der Hilfemaschine verbunden sein muss, um zu wissen, wann sie mit der Indizierung der Dokumentation beginnen kann.
Nach dem Start des Indizierungsprozesses wird das Signal indexingStarted() ausgegeben und am Ende des Indizierungsprozesses wird indexingFinished() ausgegeben. Um die Indizierung zu stoppen, kann man cancelIndexing() aufrufen.
Wenn der Indizierungsprozess beendet ist, kann die Suchmaschine verwendet werden, um den Index mit der Funktion search() nach einem bestimmten Begriff zu durchsuchen. Wenn die Sucheingabe an die Suchmaschine übergeben wird, wird das Signal searchingStarted() ausgegeben. Wenn die Suche beendet ist, wird das Signal searchingFinished() ausgegeben. Der Suchvorgang kann durch den Aufruf von cancelSearching() gestoppt werden.
Wenn die Suche erfolgreich war, wird searchingFinished() mit der Anzahl der Suchergebnisse aufgerufen, um die Suchergebnisse von der Suchmaschine zu holen. Der Aufruf der Funktion searchResults() mit einem Bereich gibt eine Liste der QHelpSearchResult Objekte innerhalb des Bereichs zurück. Die Ergebnisse bestehen aus dem Titel und der URL des Dokuments sowie einem Ausschnitt aus dem Dokument, das die beste Übereinstimmung mit der Sucheingabe enthält.
Dokumentation der Mitgliedsfunktionen
[explicit] QHelpSearchEngineCore::QHelpSearchEngineCore(QHelpEngineCore *helpEngine, QObject *parent = nullptr)
Konstruiert eine neue Suchmaschine mit der angegebenen parent. Die Suchmaschine verwendet die angegebene helpEngine, um auf die zu indizierende Dokumentation zuzugreifen. Das Signal setupFinished() von QHelpEngineCore wird automatisch mit der Indizierungsfunktion von QHelpSearchEngineCore verbunden, so dass neue Dokumentation indiziert wird, nachdem das Signal ausgegeben wurde.
[override virtual noexcept] QHelpSearchEngineCore::~QHelpSearchEngineCore()
Zerstört die Suchmaschine.
[slot] void QHelpSearchEngineCore::cancelIndexing()
Stoppt den Indizierungsprozess.
[slot] void QHelpSearchEngineCore::cancelSearching()
Stoppt den Suchvorgang.
[signal] void QHelpSearchEngineCore::indexingFinished()
Dieses Signal wird ausgegeben, wenn der Indizierungsvorgang abgeschlossen ist.
[signal] void QHelpSearchEngineCore::indexingStarted()
Dieses Signal wird ausgegeben, wenn der Indizierungsprozess gestartet wird.
[slot] void QHelpSearchEngineCore::reindexDocumentation()
Zwingt die Suchmaschine, alle Dokumentationsdateien neu zu indizieren.
[slot] void QHelpSearchEngineCore::search(const QString &searchInput)
Startet den Suchvorgang mit der angegebenen Suchphrase searchInput.
Die Phrase kann aus mehreren Wörtern bestehen. Standardmäßig gibt die Suchmaschine die Liste der Dokumente zurück, die alle angegebenen Wörter enthalten. Die Phrase kann eine beliebige Kombination der logischen Operatoren AND, OR und NOT enthalten. Der Operator muss in Großbuchstaben geschrieben werden, andernfalls wird er als Teil der Suchphrase betrachtet.
Werden doppelte Anführungszeichen verwendet, um die Wörter zu gruppieren, sucht die Suchmaschine nach einer exakten Übereinstimmung der zitierten Phrase.
Weitere Informationen über die Syntax der Textabfrage finden Sie unter SQLite FTS5 Extension.
QString QHelpSearchEngineCore::searchInput() const
Gibt die zuletzt gesuchte Phrase zurück.
int QHelpSearchEngineCore::searchResultCount() const
Gibt die Anzahl der Ergebnisse zurück, die die Suchmaschine gefunden hat.
QList<QHelpSearchResult> QHelpSearchEngineCore::searchResults(int start, int end) const
Gibt eine Liste von Suchergebnissen innerhalb des Bereichs von dem durch start angegebenen Index bis zu dem durch end angegebenen Index zurück.
[signal] void QHelpSearchEngineCore::searchingFinished()
Dieses Signal wird ausgegeben, wenn der Suchvorgang abgeschlossen ist.
[signal] void QHelpSearchEngineCore::searchingStarted()
Dieses Signal wird ausgegeben, wenn der Suchvorgang gestartet wird.
© 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.
