QAction类参备考资料(中文)

1、QAction 类参考详情请QAction 类提供了一个可以同时出现在菜单和工具条上的抽象用户界面操作。#include < qaction.h >Inherits QObject 。Inherited by QActionGroup 。所有成员函数的列表。公有成员QAction ( QObject * parent, const char * name = 0, bool toggle = FALSE )QAction ( const QString & text, const QIconSet & icon, const QString & menuTe

2、xt,QKeySequence accel, QObject * parent, const char * name = 0, bool toggleFALSE )QAction ( const QString & text, const QString & menuText, QKeySequence accel,QObject * parent, const char * name = 0, bool toggle = FALSE )QAction()virtual voidsetIconSet ( const QIconSet & )QIconSeticonSet

3、 () constvirtual voidsetText ( const QString & )QString text () constvirtual void setMenuText ( const QString & )QString menuText () constvirtual void setToolTip ( const QString & )QString toolTip () constvirtual void setStatusTip ( const QString & )QString statusTip () constvirtual

4、void setWhatsThis ( const QString & )QString whatsThis () constvirtual void setAccel ( const QKeySequence & key )QKeySequence accel () constvirtual void setToggleAction ( bool )bool isToggleAction () constbool isOn () constbool isEnabled () constvirtual booladdTo ( QWidget * w )virtual boolr

5、emoveFrom ( QWidget * w )公有槽void toggle()virtual voidsetOn ( bool )virtual voidsetEnabled ( bool )信号void activated () void toggled ( bool )属性QKeySequenee accel -操作快捷键 bool enabled -操作是否生效Qleo nSet icon Set -操作的图标QStri ngmenu Text -操作的菜单文本bool on-切换操作是否打开QStri ngstatusTip -操作的状态提示QStri ngtext -操作的描述文

6、本bool toggleAction -操作是否是切换操作QString toolTip -操作的工具提示QString whatsThis -操作的"这是什么？ ”帮助文本保护成员virtual void addedTo ( QWidget * actio nWidget, QWidget * con tai ner ) virtual void addedTo ( intin dex, QPopupMenu * menu )详细描述QAction类提供了一个可以同时出现在菜单和工具条上的抽象用户界面操作。工具条按钮和键盘快捷键调用。因在图形用户界面应用程序中很多命令可以通过菜单选

7、项、 为同一个操作将会被执行，而与它的调用方法无关，并且因为菜单和工具条必须保持同步, 所以提供一个 操作这样的命令很有用。一个操作可以被添加到菜单和工具条中并且将会自动使它们同步。例如，如果用户按下“加粗”工具条按钮，加粗”菜单项将会自动被选中。QAction 可以包含图标、菜单文本、快捷键、状态条文本、这是什么文本和工具提示。它们可以分别通过 setIconSet () 、setText () 、setMenuText ()、setToolTip ()、setStatusTip () 、setWhatsThis ()和 setAccel () 来设置。操作可以是一个切换操作，例如，一个“加

8、粗”工具条按钮，或者一个命令操作，例如“打开文件”来调用打开文件对话框。当切换操作的状态改变了，它发射toggled ()信号。当命令操作和切换按钮被调用时， 它们都发射 activated ()信号。 使用 setToggleAction ()来设置操作的切换状态。 如果要看操作是否是切换操作， 请使用 isToggleAction ()。切换操作可以是“开”，isOn ()返回真，或者“关”，isOn()返回假。操作可以使用addTo ()被添加到窗口部件(菜单或者工具条)中，并且使用removeFrom ()来移除。一旦 QAction已经被创建，它应该被添加到相应的菜单或者工具条重并且

9、然后连接到执行这个操作的槽。例如：fileSaveAction = new QAction( "Save File", QPixmap( filesave ),"&Save", CTRL+Key_S, this, "save" );connect ( fileSaveAction, SIGNAL( activated () ) , this, SLOT( save() ) );我们创建一个菜单文本为“保存 (&S) ”并且 Ctrl+S 为键盘快捷键的“文件保存”操作。我 们连接 fileSaveAction 的 ac

10、tivated ()信号到我自己的 save() 槽。注意在这时还没有菜单或 者工具条操作，接下来我们将添加它们：QToolBar * fileT ools = new QToolBar ( this, "file operations" );fileSaveAction->addTo ( fileTools );QPopupMenu * file = new QPopupMenu ( this );menuBar ()->insertitem(”&File", file );fileSaveActi on->addTo(file )；我

11、们创建了一个工具条并把我们的fileSaveAction 添加进去。类似的，我们创建一个菜单,添加一个顶级菜单项并且把我们的fileSaveAction添加进去。（对于一个更详细的实例请参考有QAction特征的简单应用程序排演我们建议把操作为它所在的窗口的子对象来创建。在绝大多数情况下操作是应用程序主窗口的子对象。为了防止循环，不要在一个稍后要添加操作的窗口部件的子对象中创建操作。也可以参考 主窗口和相关类 和基本窗口部件。成员函数文档QAction:QAction( QObject * parent, const char * name = 0, booltoggle = FALSE )构

12、造一个父对象为 P are nt并且名称为name的操作。如果toggle为真，操作将是切换操作，否则它就是命令操作。如果pare nt是QActio nGroup，新的操作会把自己插入到pare nt中。为了使快捷键和状态提示能够工作，parent必须是一个窗口部件或者一个父对象为窗口部件的操作组。QAction:QAction( const QString & text, const QlconSet & icon,const QStri ng & menu Text,QKeySeque neeaccel, QObjectparent, const char * n

13、 ame = 0, bool toggle = FALSE )构造一个有如下属性的操作：描述为 text、图标为icon、菜单文本为menuT ext并且键盘快捷键为accel。它是pare nt的子对象并且名称为 n ame。如果toggle为真，操作将是切换操作，否则它就是命令操作。如果pare nt是QActio nGroup，新的操作会把自己插入到parent 中。为了使快捷键和状态提示能够工作，parent必须是一个窗口部件或者一个父对象为窗口部件的操作组。text和accel将会用于工具提示和状态提示，除非你使用setToolTip ()和setStatusTip ()为它们提供特

14、定文本。QActi on:QAct ion ( constQStri ng & text, constQStri ng & menu Text,QKeySequeneeaccel, QObject * parent, const char * name = 0,bool toggle = FALSE )这个构造函数的结果是没有图标的操作：描述为 text、菜单文本为 menu Text并且键盘快捷键为accel。它是pare nt的子对象并且名称为name。如果toggle为真，操作将是切换操作，否则它就是命令操作。如果pare nt是QActio nGroup，新的操作会把自

15、己插入到pare nt中。为了使快捷键和状态提示能够工作，parent必须是一个窗口部件或者一个父对象为窗口部件的操作组。text和accel将会用于工具提示和状态提示，除非你使用setToolTip ()和setStatusTip ()为它们提供特定文本。QActio n:QActio n ()销毁这个对象并且释放已经分配的资源。QKeySeque nee QActi on:accel () const信号返回操作的快捷键。详细情况请参考“accel ”属性。void QAction:activated ()当操作被用户激活时，也就是说当用户点击菜单选项或者工具条按钮或者按下操作的快捷键 组

16、合时，这个信号被发射。对于命令操作连接这个信号。对于切换按钮连接toggled ()信号。例如：action/app licati on.cpp、chart/chartform.cpp禾R themes/themes.cpp 。bool QActio n:addTo (QWidget * w )虚把这个这个操作添加到窗口部件现在操作可以被添加到QToolBar和QPopupMenu 窗口部件中。被添加到菜单条中的操作会自动被显示为一个按钮,被添加到弹出菜单中的操作会自动显示(如果 w不是QToolBar 或者为一个菜单项。如果操作被添加成功，addTo ()返回真，否则返回假。QPopupMe

17、nu ，操作将不会被添加并且将返回假。) 也可以参考 removeFrom ()。acti on/app licati on.cppaction /toggleacti on/toggleact ion.cppchart/chartform.cpp禾R textedit/textedit.cpp。在QActionGroup中被重新实现。void QActi on:addedTo(QWidgetactio nWidget,QWidgetcontainer )虚保护当它在con ta in er中为这个操作创建一个窗口部件时(actio nWidget )，这个函数被addTo ()调用。void

18、 QActio n:addedTo ( int in dex,QPopupMenu * menu )虚 保护这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。index的菜单项时，这个函数被当它在弹出菜单 me nu中为这个操作创建一个索引为addTo ()调用。Qlcon Set QActio n:ico nSet () const返回操作的图标。详细情况请参考“ icon Set ”属性。bool QAction:isE nabled () const如果操作生效，返回真，否则返回假。详细情况请参考"enabled ” 属性。“on ”属性。bool QActio

19、n:is On () const如果切换操作是开的，返回真，否则返回假。详细情况请参考bool QActio n:isToggleActio n () const"toggleAction” 属性。如果操作是切换操作，返回真，否则返回假。详细情况请参考QString QAction:menuText () constQWidget * w )虚返回操作的菜单文本。详细情况请参考“ menu Text ”属性。bool QAction:removeFrom (从窗口部件w中移除操作。如果操作被成功移除，返回真，否则返回假。也可以参考 addTo ()。设置切换按钮为开。详细情况请参考“

20、 on ”属性。void QAction:setAccel ( constQKeySequenee & key )虚设置操作的快捷键为 key。详细情况请参考 “accel”属性。void QActio n:setE nabled ( bool )虚槽设置操作是否生效。详细情况请参考“ enabled ”属性。void QActio n:setlco nSet ( constQlconSet & )虚设置操作的图标。详细情况请参考“ icon Set ”属性。void QActio n:setMe nu Text ( constQString & )虚设置操作的菜单文本

21、。详细情况请参考“ menu Text ”属性。void QActio n:set On ( bool )void QActio n:setStatusTi p ( constQString & )虚QString & )虚设置操作的状态提示。详细情况请参考“ statusTip ”属性。void QAction:setText ( const设置操作的描述文本。详细情况请参考“text ”属性。void QActio n:setToggleActio n ( bool )设置操作是否是切换按钮。详细情况请参考“toggleAction” 属性。QString & )虚

22、void QActio n:setToolT ip ( const设置操作的工具提示。详细情况请参考“toolTip ” 属性。QString & )虚void QActio n:setWhatsThis ( const设置操作的“这是什么？”帮助文本。详细情况请参考“whatsThis ” 属性。QString QAction:statusTip () const返回操作的状态提示。详细情况请参考“ statusTip ”属性。QString QAction:text () const返回操作的描述文本。详细情况请参考“text ”属性。void QActio n:toggle ()

23、槽切换切换按钮的状态。也可以参考 on、toggled ()和 toggleAction 。void QAction:toggled ( bool )信号当切换按钮改变状态时，这个信号被发射，命令操作和QActionGroups不发射toggled ()。参数表示新的状态，也就是如果切换按钮被打开，为真，或者如果它被关闭，为假。依赖切换按钮是否被打开或者关闭来触发用户命令要把它连接到一个可以得到bool变量来识别状态的槽，例如:QMai nWin dow* wi ndow = new QMai nWindowQActio n * labelo no faction = new QActio n

24、( win dow, "labelo noff", TRUE );QObject: connect ( label on offactio n, SIGNAL(toggled ( bool ),wi ndow, SLOT( setUsesTextLabel ( bool );也可以参考 activated ()、toggleAction和on。实例：action/toggleact ion /toggleact ion.cppQString QAction:toolTip () const返回操作的工具提示。详细情况请参考“toolTip ” 属性。QString QAct

25、ion:whatsThis () const返回操作的“这是什么？”帮助文本。详细情况请参考“whatsThis ” 属性。属性文档QKeySequence accel这个属性保存的是操作的快捷键。键代码可以在 Qt:Key 和 Qt:Modifier 中找到。这里没有默认快捷键。通过 setAccel () 设置属性值并且通过 accel ()来获得属性值。bool enabled这个属性保存的是操作是否生效。失效的操作不能被用户选择。它们不从菜单 / 工具条上消失，但是会以某种方式表面它们不可用，例如，它们也许被变灰。失效操作上的“这是什么？”帮助还是由被设置的QAction:whatsT

26、his 属性提供。通过 setEnabled ()设置属性值并且通过 isEnabled ()来获得到属性值。QIconSet iconSet这个属性保存的是操作的图标。实例。)这个图标会用在工具条按钮和菜单中菜单文本的左面。这里没有默认图标。请参考 action/toggleaction/toggleaction.cpp通过 setIconSet ()设置属性值并且通过 iconSet () 来获得属性值。QString menuText这个属性保存的是操作的菜单文本。如果操作备添加为菜单中的一个菜单选项将会由图标如果有的话) 、菜单文本和快捷键 (如setMenuText () 中明确设置

27、， 操作果有的话) 组成。 如果没有菜单文本在构造函数或者使用 的描述文本将用来作为菜单文本。这里没有默认菜单文本。也可以参考 text 。通过 setMenuText () 设置属性值并且通过 menuText ()来获得属性值。bool on这个属性保存的是切换按钮是否为开。对于命令操作和 QActionGroup 这个属性总是开的(真) ， setOn ()对于它们没有效果。对于为真的操作，这个属性的默认值是关(假) 。也可以参考 toggleAction 。通过 setOn ()设置属性值并且通过 isOn () 来获得属性值。QString statusTip这个属性保存的是操作的状态提示。这个状态提示将会被显示在操作的顶级父窗口部件提供的所有状态条上。如果没有状态提示被定义，操作使用工具条提示文本。这里没有默认的状态提示。也可以参考 statusTip 和 toolTip 。通过 setStatusTip ()设置属