ActionBuilder 类

Core::ActionBuilder

The ActionBuilder class is convienience class to set up Core::Commands. 更多...

头文件 #include <coreplugin/actionmanager/actionmanager.h>

公开函数

ActionBuilder(QObject *contextActionParent, const Utils::Id actionId)
~ActionBuilder()
Core::ActionBuilder &adopt(Utils::Action *action)
Core::ActionBuilder &setIconText(const QString &iconText)
Core::ActionBuilder &setText(const QString &text)

详细信息

动作构建器指定了 Core::Command 和上下文动作的属性,并在其析构函数中使用 ActionManager::registerAction() 实际上为命令设置一个 Core::Context 以注册动作。

成员函数说明

ActionBuilder::ActionBuilder(QObject *contextActionParent, const Utils::Id actionId)

为标识为 actionId 的动作构造动作构建器。

contextActionParent 用于提供给内部构造的 QAction 对象为一个 QObject 父对象来控制其生命周期。

这通常是使用 ActionBuilder 的实体的 this 指针。

[noexcept] ActionBuilder::~ActionBuilder()

使用设置属性注册创建的动作。

另见 ActionManager::registerAction().

Core::ActionBuilder &ActionBuilder::adopt(Utils::Action *action)

使用给定的 action 是此构建器的上下文动作。 action 不能为 nullptr,并且必须在设置实际的属性(如 setText() 或 setIcon())之前调用 adopt()。

通常您应该更喜欢将 contextActionParent 传递给 ActionBuilder 构造函数,并使用 bindContextAction() 将 QAction 绑定到自动创建的上下文动作。

此方法有时很有用,如果调用者自己管理动作的生命周期,例如没有 QObject 可以是自动创建的上下文动作的父对象。

Core::ActionBuilder &ActionBuilder::setIconText(const QString &iconText)

设置正在构建的动作的 iconText 属性为 iconText

另请参阅QAction::setIconText()。

Core::ActionBuilder &ActionBuilder::setText(const QString &text)

设置正在构建的动作的 text 属性为 text

另请参阅QAction::setText()。

©2024 年 Qt 公司版权所有。在此包含的文档贡献是各自所有者的版权。在此提供的文档是根据自由软件基金会出版的 GNU Free Documentation License 1.3 版本 的条款许可的。Qt 和相应的标志是芬兰的 Qt 公司及其在全球的子公司和关联公司的商标。所有其他商标均为各自所有者的财产。