QHelpSearchEngineCore Class
QHelpSearchEngineCore 클래스는 색인 및 검색 문서에 대한 액세스를 제공합니다. 더 보기...
헤더: | #include <QHelpSearchEngineCore> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Help) target_link_libraries(mytarget PRIVATE Qt6::Help) |
qmake: | QT += help |
이후: | Qt 6.8 |
상속합니다: | 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) |
시그널
void | indexingFinished() |
void | indexingStarted() |
void | searchingFinished() |
void | searchingStarted() |
상세 설명
검색 엔진을 사용하기 전에 검색 엔진 생성자에 전달해야 하는 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()
검색 엔진이 모든 문서 파일을 강제로 다시 색인화하도록 합니다.
[slot]
void QHelpSearchEngineCore::search(const QString &searchInput)
주어진 검색 구문을 사용하여 검색 프로세스를 시작합니다 searchInput.
구문은 여러 단어로 구성될 수 있습니다. 기본적으로 검색 엔진은 지정된 단어가 모두 포함된 문서 목록을 반환합니다. 구문에는 논리 연산자 AND, OR, NOT의 모든 조합이 포함될 수 있습니다. 연산자는 모두 대문자로 작성해야 하며, 그렇지 않으면 검색 구문의 일부로 간주됩니다.
큰따옴표를 사용하여 단어를 그룹화할 경우 검색 엔진은 따옴표로 묶은 구문과 정확히 일치하는 검색어를 찾습니다.
텍스트 쿼리 구문에 대한 자세한 내용은 SQLite FTS5 확장을 참조하세요.
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()
이 신호는 검색 프로세스가 시작될 때 방출됩니다.
© 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.