QHelpSearchEngineCore Class
Die Klasse „QHelpSearchEngineCore“ ermöglicht den Zugriff auf die Indizierung und Suche in der Dokumentation. Mehr...
| Header: | #include <QHelpSearchEngineCore> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Help) target_link_libraries(mytarget PRIVATE Qt6::Help) |
| qmake: | QT += help |
| Seit: | Qt 6.8 |
| Erbt von: | 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() |
Ausführliche 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 Hilfe-Engines verbunden sein muss, um zu wissen, wann sie mit der Indizierung der Dokumentation beginnen kann.
Nach dem Start des Indizierungsprozesses wird das Signal ` indexingStarted()` ausgesendet, und am Ende des Indizierungsprozesses wird das Signal ` indexingFinished()` ausgesendet. Um die Indizierung zu stoppen, kann die Funktion ` cancelIndexing()` aufgerufen werden.
Ist der Indizierungsprozess abgeschlossen, kann die Suchmaschine mithilfe der Funktion ` search()` dazu verwendet werden, den Index nach einem bestimmten Begriff zu durchsuchen. Wenn die Sucheingabe an die Suchmaschine übergeben wird, wird das Signal ` searchingStarted()` ausgesendet. Nach Abschluss der Suche wird das Signal ` searchingFinished()` ausgesendet. Der Suchvorgang kann durch den Aufruf von ` cancelSearching()` gestoppt werden.
Ist die Suche erfolgreich, wird „ searchingFinished()“ mit der Anzahl der Suchergebnisse aufgerufen, um die Suchergebnisse von der Suchmaschine abzurufen. Der Aufruf der Funktion „ searchResults()“ mit einem Bereich liefert eine Liste von „ QHelpSearchResult “-Objekten innerhalb dieses Bereichs. Die Ergebnisse bestehen aus dem Dokumenttitel und der URL sowie einem Ausschnitt aus dem Dokument, der die beste Übereinstimmung mit der Suchanfrage enthält.
Dokumentation zu den Member-Funktionen
[explicit] QHelpSearchEngineCore::QHelpSearchEngineCore(QHelpEngineCore *helpEngine, QObject *parent = nullptr)
Erstellt eine neue Suchmaschine mit der angegebenen „ parent “. Die Suchmaschine nutzt die angegebene „ helpEngine “, um auf die zu indizierende Dokumentation zuzugreifen. Das Signal „setupFinished()“ von „ QHelpEngineCore “ wird automatisch mit der Indizierungsfunktion von „QHelpSearchEngineCore“ verbunden, sodass neue Dokumentation nach dem Auslösen des Signals indiziert wird.
[override virtual noexcept] QHelpSearchEngineCore::~QHelpSearchEngineCore()
Zerstört die Suchmaschine.
[slot] void QHelpSearchEngineCore::cancelIndexing()
Beendet den Indizierungsprozess.
[slot] void QHelpSearchEngineCore::cancelSearching()
Beendet den Suchvorgang.
[signal] void QHelpSearchEngineCore::indexingFinished()
Dieses Signal wird ausgegeben, wenn der Indizierungsprozess abgeschlossen ist.
[signal] void QHelpSearchEngineCore::indexingStarted()
Dieses Signal wird ausgesendet, wenn der Indizierungsprozess gestartet wird.
[slot] void QHelpSearchEngineCore::reindexDocumentation()
Zwingt die Suchmaschine dazu, alle Dokumentationsdateien neu zu indizieren.
[slot] void QHelpSearchEngineCore::search(const QString &searchInput)
Startet den Suchvorgang mit dem angegebenen Suchbegriff „ searchInput “.
Der Suchbegriff kann aus mehreren Wörtern bestehen. Standardmäßig gibt die Suchmaschine eine Liste von Dokumenten zurück, die alle angegebenen Wörter enthalten. Der Suchbegriff kann beliebige Kombinationen der logischen Operatoren AND, OR und NOT enthalten. Der Operator muss in Großbuchstaben geschrieben werden, andernfalls wird er als Teil des Suchbegriffs betrachtet.
Werden doppelte Anführungszeichen zur Gruppierung der Wörter verwendet, sucht die Suchmaschine nach einer exakten Übereinstimmung mit der in Anführungszeichen gesetzten Phrase.
Weitere Informationen zur Syntax von Textabfragen finden Sie unter „SQLite FTS5-Erweiterung“.
QString QHelpSearchEngineCore::searchInput() const
Gibt den zuletzt gesuchten Ausdruck 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 mit Suchergebnissen im Bereich vom durch ` start ` angegebenen Index bis zum 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 ausgesendet, wenn der Suchvorgang gestartet wird.
© 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.
