本页内容

QHelpFilterSettingsWidget Class

QHelpFilterSettingsWidget 类提供了一个小部件,可用于创建、编辑和删除过滤器。更多内容...

标题: #include <QHelpFilterSettingsWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS Help)
target_link_libraries(mytarget PRIVATE Qt6::Help)
qmake: QT += help
继承自: QWidget

公共函数

QHelpFilterSettingsWidget(QWidget *parent = nullptr)
virtual ~QHelpFilterSettingsWidget()
bool applySettings(QHelpFilterEngine *filterEngine) const
void readSettings(const QHelpFilterEngine *filterEngine)
void setAvailableComponents(const QStringList &components)
void setAvailableVersions(const QList<QVersionNumber> &versions)

详细说明

QHelpFilterSettingsWidget 的实例可能是首选项对话框的一部分。在显示对话框之前,应调用setAvailableComponents() 和setAvailableVersions(),否则过滤器设置控件将仅提供创建空过滤器的功能,这将毫无用处。 此外,还应调用readSettings ,以将过滤引擎中已存储的过滤器列表填充到过滤器设置控件中。新建过滤器、修改现有过滤器以及删除不需要的过滤器,均由该控件自动处理。 若需保存控件的当前状态并将其应用到过滤引擎中(例如在用户点击“应用”按钮后),请调用applySettings()。

成员函数文档

[explicit] QHelpFilterSettingsWidget::QHelpFilterSettingsWidget(QWidget *parent = nullptr)

创建一个过滤器设置小部件,其父级小部件为parent 。

[virtual noexcept] QHelpFilterSettingsWidget::~QHelpFilterSettingsWidget()

删除过滤器设置控件。

bool QHelpFilterSettingsWidget::applySettings(QHelpFilterEngine *filterEngine) const

将当前显示在此过滤器设置控件中的过滤器设置写入filterEngine 。存储在过滤器引擎中的旧设置将被覆盖。成功时返回true 。

void QHelpFilterSettingsWidget::readSettings(const QHelpFilterEngine *filterEngine)

读取存储在filterEngine 中的过滤器设置,并据此配置此过滤器设置控件。

void QHelpFilterSettingsWidget::setAvailableComponents(const QStringList &components)

将所有可用组件的列表设置为components 。

另请参阅 QHelpFilterEngine::availableComponents()。

void QHelpFilterSettingsWidget::setAvailableVersions(const QList<QVersionNumber> &versions)

将所有可用版本号的列表设置为versions 。

另请参阅 QHelpFilterEngine::availableVersions()。

© 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.