QAction 类

成员函数文档编制

QAction:: QAction ( QObject * parent = nullptr)

构造动作采用 parent 。若 parent 是动作组，动作会被自动插入组中。

注意： parent 自变量是可选的，从 Qt 5.7 起。

QAction:: QAction (const QString & text , QObject * parent = nullptr)

构造动作采用一些 text and parent 。若 parent 是动作组，动作会被自动插入组中。

The action uses a stripped version of text (e.g. "&Menu Option..." becomes "Menu Option") as descriptive text for tool buttons. You can override this by setting a specific description with setText (). The same text will be used for tooltips unless you specify a different text using setToolTip ().

QAction:: QAction (const QIcon & icon , const QString & text , QObject * parent = nullptr)

构造动作采用 icon 和一些 text and parent 。若 parent 是动作组，动作会被自动插入组中。

The action uses a stripped version of text (e.g. "&Menu Option..." becomes "Menu Option") as descriptive text for tool buttons. You can override this by setting a specific description with setText (). The same text will be used for tooltips unless you specify a different text using setToolTip ().

[virtual] QAction:: ~QAction ()

销毁对象并释放分配的资源。

QActionGroup *QAction:: actionGroup () const

Returns the action group for this action. If no action group manages this action then 0 will be returned.

另请参阅 QActionGroup and QAction::setActionGroup ().

void QAction:: activate ( QAction::ActionEvent event )

发送相关信号为 ActionEvent event .

基于动作的 Widget 使用此 API 以促使 QAction 去发射信号及发射它们自己。

QList < QGraphicsWidget *> QAction:: associatedGraphicsWidgets () const

返回已添加此动作的小部件列表。

This function was introduced in Qt 4.5.

另请参阅 QWidget::addAction () 和 associatedWidgets ().

QList < QWidget *> QAction:: associatedWidgets () const

返回已添加此动作的小部件列表。

This function was introduced in Qt 4.2.

另请参阅 QWidget::addAction () 和 associatedGraphicsWidgets ().

[signal] void QAction:: changed ()

This signal is emitted when an action has changed. If you are only interested in actions in a given widget, you can watch for QWidget::actionEvent () sent with an QEvent::ActionChanged .

注意： 通知信号为特性 autoRepeat . Notifier signal for property checkable . Notifier signal for property enabled . Notifier signal for property font . Notifier signal for property icon . Notifier signal for property iconText . Notifier signal for property iconVisibleInMenu . Notifier signal for property menuRole . Notifier signal for property shortcut . Notifier signal for property shortcutContext . Notifier signal for property shortcutVisibleInContextMenu . Notifier signal for property statusTip . Notifier signal for property text . Notifier signal for property toolTip . Notifier signal for property visible . Notifier signal for property whatsThis .

另请参阅 QWidget::actionEvent ().

QVariant QAction:: data () const

返回用户设置数据在 QAction::setData .

另请参阅 setData ().

[override virtual protected] bool QAction:: event ( QEvent * e )

Reimplemented from QObject::event ().

[slot] void QAction:: hover ()

这是调用 activate(Hover) 的方便槽。

[signal] void QAction:: hovered ()

This signal is emitted when an action is highlighted by the user; for example, when the user pauses with the cursor over a menu option, toolbar button, or presses an action's shortcut key combination.

另请参阅 QAction::activate ().

bool QAction:: isSeparator () const

返回 true 若此动作是分隔符动作；否则它返回 false .

另请参阅 QAction::setSeparator ().

QMenu *QAction:: menu () const

返回由此动作包含的菜单。包含菜单的动作可以被用于创建带子菜单的菜单项，或被插入工具栏中以创建带弹出菜单的按钮。

另请参阅 setMenu () 和 QMenu::addAction ().

QWidget *QAction:: parentWidget () const

返回父级 Widget。

void QAction:: setActionGroup ( QActionGroup * group )

把此动作组设为 group 。动作会被自动添加到组的动作列表。

组内动作将是相互排斥的。

另请参阅 QActionGroup and QAction::actionGroup ().

void QAction:: setData (const QVariant & userData )

把动作的内部数据设为给定 userData .

另请参阅 data ().

[slot] void QAction:: setDisabled ( bool b )

这是方便函数，为 enabled property, that is useful for signals--slots connections. If b is true the action is disabled; otherwise it is enabled.

void QAction:: setMenu ( QMenu * menu )

把由此动作包含的菜单设为指定 menu .

另请参阅 menu ().

void QAction:: setSeparator ( bool b )

若 b 为 true，则此动作将被认为是分隔符。

How a separator is represented depends on the widget it is inserted into. Under most circumstances the text, submenu, and icon will be ignored for separator actions.

另请参阅 QAction::isSeparator ().

void QAction:: setShortcuts (const QList < QKeySequence > & shortcuts )

集 shortcuts 作为触发动作的快捷方式列表。列表的第一元素是首要快捷方式。

This function was introduced in Qt 4.2.

另请参阅 shortcuts () 和 shortcut .

void QAction:: setShortcuts ( QKeySequence::StandardKey key )

设置从属平台的快捷方式列表基于 key . The result of calling this function will depend on the currently running platform. Note that more than one shortcut can assigned by this action. If only the primary shortcut is required, use setShortcut 代替。

This function was introduced in Qt 4.2.

另请参阅 QKeySequence::keyBindings ().

QKeySequence QAction:: shortcut () const

返回首要快捷键。

注意： Getter 函数为特性 shortcut .

另请参阅 setShortcuts ().

QList < QKeySequence > QAction:: shortcuts () const

返回快捷键列表，采用首要快捷键作为列表的第一元素。

This function was introduced in Qt 4.2.

另请参阅 setShortcuts ().

bool QAction:: showStatusText ( QWidget * widget = nullptr)

更新相关状态栏为 widget 指定通过发送 QStatusTipEvent 到其父级 Widget。返回 true 若事件被发送；否则返回 false .

若指定 null 小部件，则事件被发送给动作的父级。

另请参阅 statusTip .

[slot] void QAction:: toggle ()

这是方便函数，为 checked property. Connect to it to change the checked state to its opposite state.

[signal] void QAction:: toggled ( bool checked )

此信号被发射每当可复选动作改变其 isChecked () status. This can be the result of a user interaction, or because setChecked () was called. As setChecked () changes the QAction , it emits changed () in addition to toggled().

checked 为 true 若动作被复选，或 false 若动作被取消复选。

注意： 通知信号为特性 checked .

另请参阅 QAction::activate (), QAction::triggered ()，和 checked .

[slot] void QAction:: trigger ()

这是调用 activate(Trigger) 的方便槽。

[signal] void QAction:: triggered ( bool checked = false)

此信号被发射当动作被激活由用户；例如：当用户点击菜单选项、工具栏按钮或按下动作的快捷键组合时，或当 trigger () 被调用。显而易见，它是 not 被发射当 setChecked () 或 toggle () 被调用。

若动作是可复选的， checked 为 true 若动作被复选，或 false 若动作被取消复选。

另请参阅 QAction::activate (), QAction::toggled ()，和 checked .