本页内容

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.