📄 qaction.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/widgets/qaction.cpp:54 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QAction类</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主页</font></a>
| <a href="classes.html">
<font color="#004faf">所有的类</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的类</font></a>
| <a href="annotated.html">
<font color="#004faf">注释的类</font></a>
| <a href="groups.html">
<font color="#004faf">分组的类</font></a>
| <a href="functions.html">
<font color="#004faf">函数</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QAction类参考</h1>
<p>QAction类提供了一个可以同时出现在菜单和工具条上的抽象用户界面操作。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qaction-h.html">qaction.h</a>></tt>
<p>Inherits <a href="qobject.html">QObject</a>。
<p>Inherited by <a href="qactiongroup.html">QActionGroup</a>。
<p><a href="qaction-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QAction"><b>QAction</b></a> ( QObject * parent, const char * name = 0, bool toggle = FALSE )</div></li>
<li><div class=fn><a href="#QAction-2"><b>QAction</b></a> ( const QString & text, const QIconSet & icon, const QString & menuText, QKeySequence accel, QObject * parent, const char * name = 0, bool toggle = FALSE )</div></li>
<li><div class=fn><a href="#QAction-3"><b>QAction</b></a> ( const QString & text, const QString & menuText, QKeySequence accel, QObject * parent, const char * name = 0, bool toggle = FALSE )</div></li>
<li><div class=fn><a href="#~QAction"><b>~QAction</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setIconSet"><b>setIconSet</b></a> ( const QIconSet & )</div></li>
<li><div class=fn>QIconSet <a href="#iconSet"><b>iconSet</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#text"><b>text</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setMenuText"><b>setMenuText</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#menuText"><b>menuText</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setToolTip"><b>setToolTip</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#toolTip"><b>toolTip</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setStatusTip"><b>setStatusTip</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#statusTip"><b>statusTip</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setWhatsThis"><b>setWhatsThis</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#whatsThis"><b>whatsThis</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setAccel"><b>setAccel</b></a> ( const QKeySequence & key )</div></li>
<li><div class=fn>QKeySequence <a href="#accel"><b>accel</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setToggleAction"><b>setToggleAction</b></a> ( bool )</div></li>
<li><div class=fn>bool <a href="#isToggleAction"><b>isToggleAction</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isOn"><b>isOn</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isEnabled"><b>isEnabled</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#addTo"><b>addTo</b></a> ( QWidget * w )</div></li>
<li><div class=fn>virtual bool <a href="#removeFrom"><b>removeFrom</b></a> ( QWidget * w )</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>void <a href="#toggle"><b>toggle</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setOn"><b>setOn</b></a> ( bool )</div></li>
<li><div class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool )</div></li>
</ul>
<h2>信号</h2>
<ul>
<li><div class=fn>void <a href="#activated"><b>activated</b></a> ()</div></li>
<li><div class=fn>void <a href="#toggled"><b>toggled</b></a> ( bool )</div></li>
</ul>
<h2>属性</h2>
<ul>
<li><div class=fn>QKeySequence <a href="#accel-prop"><b>accel</b></a> - 操作快捷键</div></li>
<li><div class=fn>bool <a href="#enabled-prop"><b>enabled</b></a> - 操作是否生效</div></li>
<li><div class=fn>QIconSet <a href="#iconSet-prop"><b>iconSet</b></a> - 操作的图标</div></li>
<li><div class=fn>QString <a href="#menuText-prop"><b>menuText</b></a> - 操作的菜单文本</div></li>
<li><div class=fn>bool <a href="#on-prop"><b>on</b></a> - 切换操作是否打开</div></li>
<li><div class=fn>QString <a href="#statusTip-prop"><b>statusTip</b></a> - 操作的状态提示</div></li>
<li><div class=fn>QString <a href="#text-prop"><b>text</b></a> - 操作的描述文本</div></li>
<li><div class=fn>bool <a href="#toggleAction-prop"><b>toggleAction</b></a> - 操作是否是切换操作</div></li>
<li><div class=fn>QString <a href="#toolTip-prop"><b>toolTip</b></a> - 操作的工具提示</div></li>
<li><div class=fn>QString <a href="#whatsThis-prop"><b>whatsThis</b></a> - 操作的“这是什么？”帮助文本</div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn>virtual void <a href="#addedTo"><b>addedTo</b></a> ( QWidget * actionWidget, QWidget * container )</div></li>
<li><div class=fn>virtual void <a href="#addedTo-2"><b>addedTo</b></a> ( int index, QPopupMenu * menu )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QAction类提供了一个可以同时出现在菜单和工具条上的抽象用户界面操作。
<p> 在图形用户界面应用程序中很多命令可以通过菜单选项、工具条按钮和键盘快捷键调用。因为同一个操作将会被执行，而与它的调用方法无关，并且因为菜单和工具条必须保持同步，所以提供一个<em>操作</em>这样的命令很有用。一个操作可以被添加到菜单和工具条中并且将会自动使它们同步。例如，如果用户按下“加粗”工具条按钮，“加粗”菜单项将会自动被选中。
<p> QAction可以包含图标、菜单文本、快捷键、状态条文本、这是什么文本和工具提示。它们可以分别通过<a href="#setIconSet">setIconSet</a>()、<a href="#setText">setText</a>()、<a href="#setMenuText">setMenuText</a>()、<a href="#setToolTip">setToolTip</a>()、<a href="#setStatusTip">setStatusTip</a>()、<a href="#setWhatsThis">setWhatsThis</a>()和<a href="#setAccel">setAccel</a>()来设置。
<p> 操作可以是一个切换操作，例如，一个“加粗”工具条按钮，或者一个命令操作，例如“打开文件”来调用打开文件对话框。当切换操作的状态改变了，它发射<a href="#toggled">toggled</a>()信号。当命令操作和切换按钮被调用时，它们都发射<a href="#activated">activated</a>()信号。使用<a href="#setToggleAction">setToggleAction</a>()来设置操作的切换状态。如果要看操作是否是切换操作，请使用<a href="#isToggleAction">isToggleAction</a>()。切换操作可以是“开”，<a href="#isOn">isOn</a>()返回真，或者“关”，isOn()返回假。
<p> 操作可以使用<a href="#addTo">addTo</a>()被添加到窗口部件（菜单或者工具条）中，并且使用<a href="#removeFrom">removeFrom</a>()来移除。
<p> 一旦QAction已经被创建，它应该被添加到相应的菜单或者工具条重并且然后连接到执行这个操作的槽。例如：
<p>
<pre> fileSaveAction = new QAction( "Save File", QPixmap( filesave ),
"&Save", CTRL+Key_S, this, "save" );
<a href="qobject.html#connect">connect</a>( fileSaveAction, SIGNAL( <a href="#activated">activated</a>() ) , this, SLOT( save() ) );
</pre>
<p> 我们创建一个菜单文本为“保存(&S)”并且<em>Ctrl+S</em>为键盘快捷键的“文件保存”操作。我们连接fileSaveAction的<a href="#activated">activated</a>()信号到我自己的save()槽。注意在这时还没有菜单或者工具条操作，接下来我们将添加它们：
<p> <pre> <a href="qtoolbar.html">QToolBar</a> * fileTools = new <a href="qtoolbar.html">QToolBar</a>( this, "file operations" );
</pre><pre> fileSaveAction-><a href="#addTo">addTo</a>( fileTools );
</pre><pre> <a href="qpopupmenu.html">QPopupMenu</a> * file = new <a href="qpopupmenu.html">QPopupMenu</a>( this );
<a href="qmainwindow.html#menuBar">menuBar</a>()->insertItem( "&File", file );
</pre><pre> fileSaveAction-><a href="#addTo">addTo</a>( file );
</pre>
<p> 我们创建了一个工具条并把我们的fileSaveAction添加进去。类似的，我们创建一个菜单，添加一个顶级菜单项并且把我们的fileSaveAction添加进去。
<p> （对于一个更详细的实例请参考<a href="simple-application-action.html">有QAction特征的简单应用程序排演</a>。）
<p> 我们建议把操作为它所在的窗口的子对象来创建。在绝大多数情况下操作是应用程序主窗口的子对象。
<p> 为了防止循环，不要在一个稍后要添加操作的窗口部件的子对象中创建操作。
<p>也可以参考<a href="application.html">主窗口和相关类</a>和<a href="basic.html">基本窗口部件</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QAction"></a>QAction::QAction ( <a href="qobject.html">QObject</a> * parent, const char * name = 0, bool toggle = FALSE )
</h3>
构造一个父对象为<em>parent</em>并且名称为<em>name</em>的操作。
<p> 如果<em>toggle</em>为真，操作将是切换操作，否则它就是命令操作。
<p> 如果<em>parent</em>是<a href="qactiongroup.html">QActionGroup</a>，新的操作会把自己插入到<em>parent</em>中。
<p> 为了使快捷键和状态提示能够工作，<em>parent</em>必须是一个窗口部件或者一个父对象为窗口部件的操作组。
<h3 class=fn><a name="QAction-2"></a>QAction::QAction ( const <a href="qstring.html">QString</a> & text, const <a href="qiconset.html">QIconSet</a> & icon, const <a href="qstring.html">QString</a> & menuText, <a href="qkeysequence.html">QKeySequence</a> accel, <a href="qobject.html">QObject</a> * parent, const char * name = 0, bool toggle = FALSE )
</h3>
构造一个有如下属性的操作：描述为<em>text</em>、图标为<em>icon</em>、菜单文本为<em>menuText</em>并且键盘快捷键为<em>accel</em>。它是<em>parent</em>的子对象并且名称为<em>name</em>。如果<em>toggle</em>为真，操作将是切换操作，否则它就是命令操作。
<p> 如果<em>parent</em>是<a href="qactiongroup.html">QActionGroup</a>，新的操作会把自己插入到<em>parent</em>中。
<p> 为了使快捷键和状态提示能够工作，<em>parent</em>必须是一个窗口部件或者一个父对象为窗口部件的操作组。
<p> <em>text</em>和<em>accel</em>将会用于工具提示和状态提示，除非你使用<a href="#setToolTip">setToolTip</a>()和<a href="#setStatusTip">setStatusTip</a>()为它们提供特定文本。
<h3 class=fn><a name="QAction-3"></a>QAction::QAction ( const <a href="qstring.html">QString</a> & text, const <a href="qstring.html">QString</a> & menuText, <a href="qkeysequence.html">QKeySequence</a> accel, <a href="qobject.html">QObject</a> * parent, const char * name = 0, bool toggle = FALSE )
</h3>
这个构造函数的结果是没有图标的操作：描述为<em>text</em>、菜单文本为<em>menuText</em>并且键盘快捷键为<em>accel</em>。它是<em>parent</em>的子对象并且名称为<em>name</em>。如果<em>toggle</em>为真，操作将是切换操作，否则它就是命令操作。
<p> 如果<em>parent</em>是<a href="qactiongroup.html">QActionGroup</a>，新的操作会把自己插入到<em>parent</em>中。
<p> 为了使快捷键和状态提示能够工作，<em>parent</em>必须是一个窗口部件或者一个父对象为窗口部件的操作组。
<p> <em>text</em>和<em>accel</em>将会用于工具提示和状态提示，除非你使用<a href="#setToolTip">setToolTip</a>()和<a href="#setStatusTip">setStatusTip</a>()为它们提供特定文本。
<h3 class=fn><a name="~QAction"></a>QAction::~QAction ()
</h3>
销毁这个对象并且释放已经分配的资源。
<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel"></a>QAction::accel () const
</h3>
<p>返回操作的快捷键。详细情况请参考<a href="qaction.html#accel-prop">“accel”</a>属性。
<h3 class=fn>void <a name="activated"></a>QAction::activated ()<tt> [信号]</tt>
</h3>
<p> 当操作被用户激活时，也就是说当用户点击菜单选项或者工具条按钮或者按下操作的快捷键组合时，这个信号被发射。
<p> 对于命令操作连接这个信号。对于切换按钮连接<a href="#toggled">toggled</a>()信号。
<p>例如：<a href="qaction-application-example.html#x1059">action/application.cpp</a>、<a href="canvas-chart-example.html#x2586">chart/chartform.cpp</a>和<a href="themes-example.html#x276">themes/themes.cpp</a>。
<h3 class=fn>bool <a name="addTo"></a>QAction::addTo ( <a href="qwidget.html">QWidget</a> * w )<tt> [虚]</tt>
</h3>
把这个这个操作添加到窗口部件<em>w</em>。
<p> 现在操作可以被添加到<a href="qtoolbar.html">QToolBar</a>和<a href="qpopupmenu.html">QPopupMenu</a>窗口部件中。
<p> 被添加到菜单条中的操作会自动被显示为一个按钮，被添加到弹出菜单中的操作会自动显示为一个菜单项。
<p> 如果操作被添加成功，<a href="#addTo">addTo</a>()返回真，否则返回假。（如果<em>w</em>不是QToolBar或者QPopupMenu，操作将不会被添加并且将返回假。）
<p> <p>也可以参考<a href="#removeFrom">removeFrom</a>()。
<p>例如：<a href="qaction-application-example.html#x1060">action/application.cpp</a>、<a href="toggleaction-example.html#x2805">action/toggleaction/toggleaction.cpp</a>、<a href="canvas-chart-example.html#x2587">chart/chartform.cpp</a>和<a href="qactiongroup.html#x2079">textedit/textedit.cpp</a>。
<p>在<a href="qactiongroup.html#addTo">QActionGroup</a>中被重新实现。
<h3 class=fn>void <a name="addedTo"></a>QAction::addedTo ( <a href="qwidget.html">QWidget</a> * actionWidget, <a href="qwidget.html">QWidget</a> * container )<tt> [虚 保护]</tt>
</h3>
当它在<em>container</em>中为这个操作创建一个窗口部件时（<em>actionWidget</em>），这个函数被<a href="#addTo">addTo</a>()调用。
<h3 class=fn>void <a name="addedTo-2"></a>QAction::addedTo ( int index, <a href="qpopupmenu.html">QPopupMenu</a> * menu )<tt> [虚 保护]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 当它在弹出菜单<em>menu</em>中为这个操作创建一个索引为<em>index</em>的菜单项时，这个函数被<a href="#addTo">addTo</a>()调用。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -