qaction.html

QT参考文档

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet"></a>QAction::iconSet () const
</h3>
<p>返回操作的图标。详细情况请参考<a href="qaction.html#iconSet-prop">“iconSet”</a>属性。

<h3 class=fn>bool <a name="isEnabled"></a>QAction::isEnabled () const
</h3>
<p>如果操作生效，返回真，否则返回假。详细情况请参考<a href="qaction.html#enabled-prop">“enabled”</a>属性。

<h3 class=fn>bool <a name="isOn"></a>QAction::isOn () const
</h3>
<p>如果切换操作是开的，返回真，否则返回假。详细情况请参考<a href="qaction.html#on-prop">“on”</a>属性。

<h3 class=fn>bool <a name="isToggleAction"></a>QAction::isToggleAction () const
</h3>
<p>如果操作是切换操作，返回真，否则返回假。详细情况请参考<a href="qaction.html#toggleAction-prop">“toggleAction”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="menuText"></a>QAction::menuText () const
</h3>
<p>返回操作的菜单文本。详细情况请参考<a href="qaction.html#menuText-prop">“menuText”</a>属性。

<h3 class=fn>bool <a name="removeFrom"></a>QAction::removeFrom ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w )<tt> [虚]</tt>
</h3>
从窗口部件<em>w</em>中移除操作。
<p> 如果操作被成功移除，返回真，否则返回假。
<p> <p>也可以参考<a href="#addTo">addTo</a>()。

<h3 class=fn>void <a name="setAccel"></a>QAction::setAccel ( const&nbsp;<a href="qkeysequence.html">QKeySequence</a>&nbsp;&amp;&nbsp;key )<tt> [虚]</tt>
</h3>
<p>设置操作的快捷键为<em>key</em>。详细情况请参考<a href="qaction.html#accel-prop">“accel”</a>属性。

<h3 class=fn>void <a name="setEnabled"></a>QAction::setEnabled ( bool )<tt> [虚 槽]</tt>
</h3>
<p>设置操作是否生效。详细情况请参考<a href="qaction.html#enabled-prop">“enabled”</a>属性。

<h3 class=fn>void <a name="setIconSet"></a>QAction::setIconSet ( const&nbsp;<a href="qiconset.html">QIconSet</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的图标。详细情况请参考<a href="qaction.html#iconSet-prop">“iconSet”</a>属性。

<h3 class=fn>void <a name="setMenuText"></a>QAction::setMenuText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的菜单文本。详细情况请参考<a href="qaction.html#menuText-prop">“menuText”</a>属性。

<h3 class=fn>void <a name="setOn"></a>QAction::setOn ( bool )<tt> [虚 槽]</tt>
</h3>
<p>设置切换按钮为开。详细情况请参考<a href="qaction.html#on-prop">“on”</a>属性。

<h3 class=fn>void <a name="setStatusTip"></a>QAction::setStatusTip ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的状态提示。详细情况请参考<a href="qaction.html#statusTip-prop">“statusTip”</a>属性。

<h3 class=fn>void <a name="setText"></a>QAction::setText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的描述文本。详细情况请参考<a href="qaction.html#text-prop">“text”</a>属性。

<h3 class=fn>void <a name="setToggleAction"></a>QAction::setToggleAction ( bool )<tt> [虚]</tt>
</h3>
<p>设置操作是否是切换按钮。详细情况请参考<a href="qaction.html#toggleAction-prop">“toggleAction”</a>属性。

<h3 class=fn>void <a name="setToolTip"></a>QAction::setToolTip ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的工具提示。详细情况请参考<a href="qaction.html#toolTip-prop">“toolTip”</a>属性。

<h3 class=fn>void <a name="setWhatsThis"></a>QAction::setWhatsThis ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; )<tt> [虚]</tt>
</h3>
<p>设置操作的“这是什么？”帮助文本。详细情况请参考<a href="qaction.html#whatsThis-prop">“whatsThis”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="statusTip"></a>QAction::statusTip () const
</h3>
<p>返回操作的状态提示。详细情况请参考<a href="qaction.html#statusTip-prop">“statusTip”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QAction::text () const
</h3>
<p>返回操作的描述文本。详细情况请参考<a href="qaction.html#text-prop">“text”</a>属性。

<h3 class=fn>void <a name="toggle"></a>QAction::toggle ()<tt> [槽]</tt>
</h3>
切换切换按钮的状态。
<p> <p>也可以参考<a href="#on-prop">on</a>、<a href="#toggled">toggled</a>()和<a href="#toggleAction-prop">toggleAction</a>。

<h3 class=fn>void <a name="toggled"></a>QAction::toggled ( bool )<tt> [信号]</tt>
</h3> 
<p> 当切换按钮改变状态时，这个信号被发射，命令操作和QActionGroups不发射<a href="#toggled">toggled</a>()。
<p> 参数表示新的状态，也就是如果切换按钮被打开，为真，或者如果它被关闭，为假。
<p> 依赖切换按钮是否被打开或者关闭来触发用户命令要把它连接到一个可以得到bool变量来识别状态的槽，例如：
<p> 

<pre>        <a href="qmainwindow.html">QMainWindow</a> * window = new <a href="qmainwindow.html">QMainWindow</a>;
</pre><pre>        QAction * labelonoffaction = new QAction( window, "labelonoff", TRUE );
</pre><pre>    <a name="x2076"></a>    QObject::<a href="qobject.html#connect">connect</a>( labelonoffaction, SIGNAL( <a href="#toggled">toggled</a>( bool ) ),
    <a name="x2077"></a>                      window, SLOT( <a href="qmainwindow.html#setUsesTextLabel">setUsesTextLabel</a>( bool ) ) );
</pre>
<p> <p>也可以参考<a href="#activated">activated</a>()、<a href="#toggleAction-prop">toggleAction</a>和<a href="#on-prop">on</a>。
<p>实例：<a href="qaction.html#x2076">action/toggleaction/toggleaction.cpp</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="toolTip"></a>QAction::toolTip () const
</h3>
<p>返回操作的工具提示。详细情况请参考<a href="qaction.html#toolTip-prop">“toolTip”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="whatsThis"></a>QAction::whatsThis () const
</h3>
<p>返回操作的“这是什么？”帮助文本。详细情况请参考<a href="qaction.html#whatsThis-prop">“whatsThis”</a>属性。

<hr><h2>属性文档</h2>
<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel-prop"></a>accel</h3> 
<p>这个属性保存的是操作的快捷键。
<p>键代码可以在<a href="qt.html#Key-enum">Qt::Key</a>和<a href="qt.html#Modifier-enum">Qt::Modifier</a>中找到。这里没有默认快捷键。
<p>通过<a href="#setAccel">setAccel</a>()设置属性值并且通过<a href="#accel">accel</a>()来获得属性值。

<h3 class=fn>bool <a name="enabled-prop"></a>enabled</h3> 
<p>这个属性保存的是操作是否生效。
<p>失效的操作不能被用户选择。它们不从菜单/工具条上消失，但是会以某种方式表面它们不可用，例如，它们也许被变灰。
<p> 失效操作上的“这是什么？”帮助还是由被设置的<a href="#whatsThis-prop">QAction::whatsThis</a>属性提供。
<p>通过<a href="#setEnabled">setEnabled</a>()设置属性值并且通过<a href="#isEnabled">isEnabled</a>()来获得到属性值。

<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet-prop"></a>iconSet</h3> 
<p>这个属性保存的是操作的图标。
<p>这个图标会用在工具条按钮和菜单中菜单文本的左面。这里没有默认图标。
<p> （请参考action/toggleaction/toggleaction.cpp实例。）
<p>通过<a href="#setIconSet">setIconSet</a>()设置属性值并且通过<a href="#iconSet">iconSet</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="menuText-prop"></a>menuText</h3> 
<p>这个属性保存的是操作的菜单文本。
<p>如果操作备添加为菜单中的一个菜单选项将会由图标（如果有的话）、菜单文本和快捷键（如果有的话）组成。如果没有菜单文本在构造函数或者使用<a href="#setMenuText">setMenuText</a>()中明确设置，操作的描述文本将用来作为菜单文本。这里没有默认菜单文本。
<p> <p>也可以参考<a href="#text-prop">text</a>。
<p>通过<a href="#setMenuText">setMenuText</a>()设置属性值并且通过<a href="#menuText">menuText</a>()来获得属性值。

<h3 class=fn>bool <a name="on-prop"></a>on</h3>
<p>这个属性保存的是切换按钮是否为开。
<p>对于命令操作和<a href="qactiongroup.html">QActionGroup</a>这个属性总是开的（真），<a href="#setOn">setOn</a>()对于它们没有效果。对于为真的操作，这个属性的默认值是关（假）。
<p> <p>也可以参考<a href="#toggleAction-prop">toggleAction</a>。
<p>通过<a href="#setOn">setOn</a>()设置属性值并且通过<a href="#isOn">isOn</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="statusTip-prop"></a>statusTip</h3> 
<p>这个属性保存的是操作的状态提示。
<p>这个状态提示将会被显示在操作的顶级父窗口部件提供的所有状态条上。
<p> 如果没有状态提示被定义，操作使用工具条提示文本。
<p> 这里没有默认的状态提示。
<p> <p>也可以参考<a href="#statusTip-prop">statusTip</a>和<a href="#toolTip-prop">toolTip</a>。
<p>通过<a href="#setStatusTip">setStatusTip</a>()设置属性值并且通过<a href="#statusTip">statusTip</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="text-prop"></a>text</h3> 
<p>这个属性保存的是操作的描述文本。
<p>如果<a href="qmainwindow.html#usesTextLabel-prop">QMainWindow::usesTextLabel</a>为真，文本将会作为相应工具按钮上的文本。如果没有菜单文本和工具条提示被定义，它也可以作为相应的默认文本。这里没有默认的文本。
<p> <p>也可以参考<a href="#menuText-prop">menuText</a>、<a href="#toolTip-prop">toolTip</a>和<a href="#statusTip-prop">statusTip</a>。
<p>通过<a href="#setText">setText</a>()设置属性值并且通过<a href="#text">text</a>()来获得属性值。

<h3 class=fn>bool <a name="toggleAction-prop"></a>toggleAction</h3>
<p>这个属性保存的是操作是否是切换操作。
<p>切换操作的状态为开/关中的一种。例如，“加粗”工具条按钮是开或者是开。不是切换操作的操作是命令操作，命令操作被简单执行。这个属性默认为假。
<p> 在一些情况下，切换操作的状态依赖于其它切换操作状态。例如，“左对齐”、“中间对齐”和“右对齐”切换操作是互斥的。为了达到互斥切换，把相关切换操作添加到<a href="qactiongroup.html">QActionGroup</a>中，并且把<a href="qactiongroup.html#exclusive-prop">QActionGroup::exclusive</a>属性设置为真。
<p>通过<a href="#setToggleAction">setToggleAction</a>()设置属性值并且通过<a href="#isToggleAction">isToggleAction</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="toolTip-prop"></a>toolTip</h3>
<p>这个属性保存得失操作的工具提示。
<p>这个文本用于工具提示。如果没有状态提示被设置，工具提示会被用作状态提示。
<p> 如果没有指定工具提示，那么操作的文本被使用并且如果没有指定操作的文本没有被指定，那么描述文本将被用作工具提示。
<p> 这里没有默认工具提示文本。
<p> <p>也可以参考<a href="#statusTip-prop">statusTip</a>和<a href="#accel-prop">accel</a>。
<p>通过<a href="#setToolTip">setToolTip</a>()设置属性值并且通过<a href="#toolTip">toolTip</a>()来获得属性值。

<h3 class=fn><a href="qstring.html">QString</a> <a name="whatsThis-prop"></a>whatsThis</h3>
<p>这个属性保存的是操作的“这是什么？”帮助文本。
<p>“这是什么？”文本被用来提供操作的简要描述。这个文本中可以使用多信息文本（比如HTML标记——对于支持的标记得列表请参考<a href="qstylesheet.html">QStyleSheet</a>）。这里没有默认的“这是什么？”文本。
<p> <p>也可以参考<a href="qwhatsthis.html">QWhatsThis</a>。
<p>通过<a href="#setWhatsThis">setWhatsThis</a>()设置属性值并且通过<a href="#whatsThis">whatsThis</a>()来获得属性值。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>