命令类

成员函数文档

QAction *Command::action() const

返回此命令的用户可见动作。使用此动作将它放置在例如工具按钮上。该操作会自动将 triggered() 和 toggled() 信号转发给当前活跃为该命令的动作。它还会在工具提示中显示当前主键盘快捷键（除了活动动作的工具提示），在没有活动动作时禁用/隐藏。

[signal] void Command::activeStateChanged()

当命令的活跃状态改变时，发出此信号。

void Command::augmentActionWithShortcutToolTip(QAction *a) const

设置动作a的工具提示为动作文本，并附加命令的主要快捷键。当主要快捷键或动作文本发生变化时，工具提示会自动更新。

另请参阅stringWithAppendedShortcut() 和 createActionWithShortcutToolTip()。

Core::Context Command::context() const

返回此命令的上下文。

[静态] QAction *Command::createActionWithShortcutToolTip(Utils::Id commandId, QObject *parent)

返回一个新的 QAction，其中包含命令的图标、图标文本和文本，由commandId提供。将按钮的父对象设置为parent。动作的工具提示是动作文本，附加了命令的主要快捷键。其他动作属性不会自动更新。

另请参阅augmentActionWithShortcutToolTip。

[静态] QToolButton *Command::createToolButtonWithShortcutToolTip(Utils::Id commandId, QWidget *parent = nullptr)

返回一个新的QToolButton，其中包含命令的图标、图标文本和文本，由commandId提供。将按钮的父对象设置为parent。动作的工具提示是动作文本，附加了命令的主要快捷键。按钮的其他属性不会自动更新。

另请参阅createActionWithShortcutToolTip。

QList<QKeySequence> Command::defaultKeySequences() const

返回可以用来激活此命令的默认键盘快捷键。

另请参阅setDefaultKeySequences。

QString Command::description() const

返回用于将此命令呈现给用户的文本。

另请参阅setDescription。

bool Command::hasAttribute(Core::Command::CommandAttribute attribute) const

返回命令是否设置了attribute。

另请参阅CommandAttribute、removeAttribute 和 setAttribute。

bool Command::isActive() const

返回命令是否具有针对当前上下文的激活动作。

bool Command::isScriptable() const

返回命令是否可脚本化。可脚本化的命令可以从脚本中调用，而无需用户与之交互。

QKeySequence 命令::keySequence() const

返回分配给此命令的当前主键盘快捷键。

另请参阅 defaultKeySequences。

[信号] void Command::keySequenceChanged()

在分配给此命令的键盘快捷键更改时发送，例如，当用户在键盘快捷键设置对话框中设置它们时。

QList<QKeySequence> Command::keySequences() const

返回分配给此命令的当前键盘快捷键。

另请参阅 defaultKeySequences。

void Command::removeAttribute(Core::Command::CommandAttribute attribute)

从此命令的属性中移除 attribute。

另请参阅 CommandAttribute 和 setAttribute。

void Command::setAttribute(Core::Command::CommandAttribute attribute)

将 attribute 添加到此命令的属性中。

另请参阅 CommandAttribute、removeAttribute 和 hasAttribute。

void Command::setDefaultKeySequence(const QKeySequence &key)

将用于激活此命令的默认键盘快捷键设置为 key。如果用户没有自定义快捷键，或者将快捷键重置为默认值，将使用此功能。

void Command::setDefaultKeySequences(const QList<QKeySequence> &keys)

将用于激活此命令的默认键盘快捷键设置为 keys。如果用户没有自定义快捷键，或者将快捷键重置为默认值，将使用此功能。

另请参阅 defaultKeySequences。

void Command::setDescription(const QString &text)

设置用于在键盘快捷键设置对话框中表示命令的 text。如果您不设置它，则取用户可见操作的当前文本（在许多情况下这是可以的）。

另请参阅 description。

void Command::setTouchBarIcon(const QIcon &icon)

将触摸条上操作的图标设置为 icon。

另请参阅 touchBarIcon。

void Command::setTouchBarText(const QString &text)

将触摸条上操作的文本设置为 text。

另请参阅 touchBarText。

QString 命令::stringsWithAppendedShortcut(const QString &string) const

返回带有当前分配给此命令的主要键盘快捷方式的字符串表示形式。

[static] QToolButton *命令::toolButtonWithAppendedShortcut(QAction *action, Core::Command *cmd)

返回用于action的工具按钮。

将主键盘快捷方式cmd追加到动作的工具提示中。

[static] QToolButton *命令::toolButtonWithAppendedShortcut(QAction *action, Utils::Id commandId)

返回用于action的工具按钮。

将ID为commandId的命令的主要键盘快捷方式追加到按钮的工具提示中。

QIcon 命令::touchBarIcon() const

返回触摸栏上的动作图标。

另请参阅 setTouchBarIcon().

QString 命令::touchBarText() const

返回触摸栏上的动作文本。

另请参阅 setTouchBarText().