QHelpFilterEngine Class
QHelpFilterEngine 클래스는 도움말 내용을 필터링하여 표시해 줍니다. 더 보기...
| 헤더: | #include <QHelpFilterEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Help) target_link_libraries(mytarget PRIVATE Qt6::Help) |
| qmake: | QT += help |
| 상속: | QObject |
공개 함수
| QString | activeFilter() const |
| QStringList | availableComponents() const |
| QList<QVersionNumber> | availableVersions() const |
| QHelpFilterData | filterData(const QString &filterName) const |
| QStringList | filters() const |
| QStringList | indices() const |
| QStringList | indices(const QString &filterName) const |
| QMap<QString, QString> | namespaceToComponent() const |
| QMap<QString, QVersionNumber> | namespaceToVersion() const |
| QStringList | namespacesForFilter(const QString &filterName) const |
| bool | removeFilter(const QString &filterName) |
| bool | setActiveFilter(const QString &filterName) |
| bool | setFilterData(const QString &filterName, const QHelpFilterData &filterData) |
신호
| void | filterActivated(const QString &newFilter) |
상세 설명
필터 엔진을 사용하면 QHelpEngineCore 인스턴스와 연관된 필터를 관리할 수 있습니다. 도움말 엔진은 내부적으로 필터 엔진의 인스턴스를 생성하며, 이 인스턴스는 QHelpEngineCore::filterEngine()을 호출하여 액세스할 수 있습니다. 따라서 이 클래스의 공용 생성자는 비활성화되어 있습니다.
필터는 필터 이름 문자열로 식별됩니다. 필터에 대한 자세한 내용은 QHelpFilterData 클래스에 설명되어 있습니다.
필터 엔진은 setFilterData() 메서드를 통해 새 필터를 추가하거나 기존 필터의 데이터를 변경할 수 있게 해줍니다. 기존 필터는 removeFilter() 메서드를 통해 제거할 수 있습니다.
등록된 필터 중 하나를 활성 필터로 지정할 수 있습니다. 활성 필터는 관련 도움말 엔진에서 콘텐츠, 색인 또는 검색 결과와 같은 다양한 기능의 필터링된 결과를 반환하는 데 사용됩니다. 활성 필터로 지정된 필터가 없는 경우, 도움말 엔진은 사용 가능한 전체 결과 목록을 반환합니다.
활성 필터는 ` activeFilter()` 메서드를 통해 반환되며, ` setActiveFilter()` 메서드를 통해 변경할 수 있습니다.
QHelpEngineCore도 참조하십시오 .
멤버 함수 문서
QString QHelpFilterEngine::activeFilter() const
현재 활성화된 필터의 이름을 반환합니다.
setActiveFilter()도 참조하십시오 .
QStringList QHelpFilterEngine::availableComponents() const
등록된 모든 문서 파일에 정의된 사용 가능한 모든 구성 요소의 목록을 반환합니다.
QList<QVersionNumber> QHelpFilterEngine::availableVersions() const
등록된 모든 문서 파일에 정의된 사용 가능한 모든 버전의 목록을 반환합니다.
[signal] void QHelpFilterEngine::filterActivated(const QString &newFilter)
이 신호는 활성 필터가 설정될 때 발생합니다. ` newFilter `는 필터의 이름을 지정합니다.
setActiveFilter()도 참조하십시오 .
QHelpFilterData QHelpFilterEngine::filterData(const QString &filterName) const
filterName 와 관련된 필터 세부 정보를 반환합니다.
setFilterData()도 참조하십시오 .
QStringList QHelpFilterEngine::filters() const
필터 엔진 내에 정의된 모든 필터 이름의 목록을 반환합니다.
QStringList QHelpFilterEngine::indices() const
사용 가능한 인덱스 목록을 정렬하여 반환합니다. 반환되는 목록의 내용은 활성 필터에 따라 달라지므로, 활성 필터에 등록된 인덱스만 반환됩니다.
QStringList QHelpFilterEngine::indices(const QString &filterName) const
filterName 로 필터링된 사용 가능한 인덱스의 정렬된 목록을 반환합니다. 반환되는 목록의 내용은 전달된 필터에 따라 달라지므로, 해당 필터에 등록된 인덱스만 반환됩니다. 필터링 없이 사용 가능한 모든 인덱스를 얻으려면 filterName 에 빈 문자열을 전달하십시오.
QMap<QString, QString> QHelpFilterEngine::namespaceToComponent() const
사용 가능한 모든 네임스페이스를 키로, 해당 네임스페이스에 연결된 컴포넌트를 값으로 갖는 맵을 반환합니다.
QMap<QString, QVersionNumber> QHelpFilterEngine::namespaceToVersion() const
사용 가능한 모든 네임스페이스를 키로, 해당 버전을 값으로 하는 맵을 반환합니다.
QStringList QHelpFilterEngine::namespacesForFilter(const QString &filterName) const
filterName 로 지정된 필터 조건에 부합하는, 등록된 모든 문서 네임스페이스 목록을 반환합니다.
bool QHelpFilterEngine::removeFilter(const QString &filterName)
filterName 로 식별되는 필터를 제거합니다.
필터 제거에 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
bool QHelpFilterEngine::setActiveFilter(const QString &filterName)
현재 활성화된 필터를 ‘ filterName ’로 변경합니다.
필터 변경에 성공하면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.
activeFilter()도 참조하십시오 .
bool QHelpFilterEngine::setFilterData(const QString &filterName, const QHelpFilterData &filterData)
filterName 로 식별되는 필터의 기존 필터 세부 정보를 filterData 로 변경합니다. 필터가 존재하지 않으면 새 필터가 생성됩니다.
필터 설정이 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
filterData()함수도 참조하십시오 .
© 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.
