QAction類參備考資料(中文)

1、QAction 類參考詳情請(qǐng)QAction 類提供了一個(gè)可以同時(shí)出現(xiàn)在菜單和工具條上的抽象用戶界面操作。#include < qaction.h >Inherits QObject 。Inherited by QActionGroup 。所有成員函數(shù)的列表。公有成員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 )信號(hào)void activated () void toggled ( bool )屬性QKeySequenee accel -操作快捷鍵 bool enabled -操作是否生效Qleo nSet icon Set -操作的圖標(biāo)QStri ngmenu Text -操作的菜單文本bool on-切換操作是否打開QStri ngstatusTip -操作的狀態(tài)提示QStri ngtext -操作的描述文

6、本bool toggleAction -操作是否是切換操作QString toolTip -操作的工具提示QString whatsThis -操作的"這是什么？ ”幫助文本保護(hù)成員virtual void addedTo ( QWidget * actio nWidget, QWidget * con tai ner ) virtual void addedTo ( intin dex, QPopupMenu * menu )詳細(xì)描述QAction類提供了一個(gè)可以同時(shí)出現(xiàn)在菜單和工具條上的抽象用戶界面操作。工具條按鈕和鍵盤快捷鍵調(diào)用。因在圖形用戶界面應(yīng)用程序中很多命令可以通過菜單選

7、項(xiàng)、 為同一個(gè)操作將會(huì)被執(zhí)行，而與它的調(diào)用方法無關(guān)，并且因?yàn)椴藛魏凸ぞ邨l必須保持同步, 所以提供一個(gè) 操作這樣的命令很有用。一個(gè)操作可以被添加到菜單和工具條中并且將會(huì)自動(dòng)使它們同步。例如，如果用戶按下“加粗”工具條按鈕，加粗”菜單項(xiàng)將會(huì)自動(dòng)被選中。QAction 可以包含圖標(biāo)、菜單文本、快捷鍵、狀態(tài)條文本、這是什么文本和工具提示。它們可以分別通過 setIconSet () 、setText () 、setMenuText ()、setToolTip ()、setStatusTip () 、setWhatsThis ()和 setAccel () 來設(shè)置。操作可以是一個(gè)切換操作，例如，一個(gè)“加

8、粗”工具條按鈕，或者一個(gè)命令操作，例如“打開文件”來調(diào)用打開文件對(duì)話框。當(dāng)切換操作的狀態(tài)改變了，它發(fā)射toggled ()信號(hào)。當(dāng)命令操作和切換按鈕被調(diào)用時(shí)， 它們都發(fā)射 activated ()信號(hào)。 使用 setToggleAction ()來設(shè)置操作的切換狀態(tài)。 如果要看操作是否是切換操作， 請(qǐng)使用 isToggleAction ()。切換操作可以是“開”，isOn ()返回真，或者“關(guān)”，isOn()返回假。操作可以使用addTo ()被添加到窗口部件(菜單或者工具條)中，并且使用removeFrom ()來移除。一旦 QAction已經(jīng)被創(chuàng)建，它應(yīng)該被添加到相應(yīng)的菜單或者工具條重并且

9、然后連接到執(zhí)行這個(gè)操作的槽。例如：fileSaveAction = new QAction( "Save File", QPixmap( filesave ),"&Save", CTRL+Key_S, this, "save" );connect ( fileSaveAction, SIGNAL( activated () ) , this, SLOT( save() ) );我們創(chuàng)建一個(gè)菜單文本為“保存 (&S) ”并且 Ctrl+S 為鍵盤快捷鍵的“文件保存”操作。我 們連接 fileSaveAction 的 ac

10、tivated ()信號(hào)到我自己的 save() 槽。注意在這時(shí)還沒有菜單或 者工具條操作，接下來我們將添加它們：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、們創(chuàng)建了一個(gè)工具條并把我們的fileSaveAction 添加進(jìn)去。類似的，我們創(chuàng)建一個(gè)菜單,添加一個(gè)頂級(jí)菜單項(xiàng)并且把我們的fileSaveAction添加進(jìn)去。（對(duì)于一個(gè)更詳細(xì)的實(shí)例請(qǐng)參考有QAction特征的簡單應(yīng)用程序排演我們建議把操作為它所在的窗口的子對(duì)象來創(chuàng)建。在絕大多數(shù)情況下操作是應(yīng)用程序主窗口的子對(duì)象。為了防止循環(huán)，不要在一個(gè)稍后要添加操作的窗口部件的子對(duì)象中創(chuàng)建操作。也可以參考 主窗口和相關(guān)類 和基本窗口部件。成員函數(shù)文檔QAction:QAction( QObject * parent, const char * name = 0, booltoggle = FALSE )構(gòu)

12、造一個(gè)父對(duì)象為 P are nt并且名稱為name的操作。如果toggle為真，操作將是切換操作，否則它就是命令操作。如果pare nt是QActio nGroup，新的操作會(huì)把自己插入到pare nt中。為了使快捷鍵和狀態(tài)提示能夠工作，parent必須是一個(gè)窗口部件或者一個(gè)父對(duì)象為窗口部件的操作組。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 )構(gòu)造一個(gè)有如下屬性的操作：描述為 text、圖標(biāo)為icon、菜單文本為menuT ext并且鍵盤快捷鍵為accel。它是pare nt的子對(duì)象并且名稱為 n ame。如果toggle為真，操作將是切換操作，否則它就是命令操作。如果pare nt是QActio nGroup，新的操作會(huì)把自己插入到parent 中。為了使快捷鍵和狀態(tài)提示能夠工作，parent必須是一個(gè)窗口部件或者一個(gè)父對(duì)象為窗口部件的操作組。text和accel將會(huì)用于工具提示和狀態(tài)提示，除非你使用setToolTip ()和setStatusTip ()為它們提供特

14、定文本。QActi on:QAct ion ( constQStri ng & text, constQStri ng & menu Text,QKeySequeneeaccel, QObject * parent, const char * name = 0,bool toggle = FALSE )這個(gè)構(gòu)造函數(shù)的結(jié)果是沒有圖標(biāo)的操作：描述為 text、菜單文本為 menu Text并且鍵盤快捷鍵為accel。它是pare nt的子對(duì)象并且名稱為name。如果toggle為真，操作將是切換操作，否則它就是命令操作。如果pare nt是QActio nGroup，新的操作會(huì)把自

15、己插入到pare nt中。為了使快捷鍵和狀態(tài)提示能夠工作，parent必須是一個(gè)窗口部件或者一個(gè)父對(duì)象為窗口部件的操作組。text和accel將會(huì)用于工具提示和狀態(tài)提示，除非你使用setToolTip ()和setStatusTip ()為它們提供特定文本。QActio n:QActio n ()銷毀這個(gè)對(duì)象并且釋放已經(jīng)分配的資源。QKeySeque nee QActi on:accel () const信號(hào)返回操作的快捷鍵。詳細(xì)情況請(qǐng)參考“accel ”屬性。void QAction:activated ()當(dāng)操作被用戶激活時(shí)，也就是說當(dāng)用戶點(diǎn)擊菜單選項(xiàng)或者工具條按鈕或者按下操作的快捷鍵 組

16、合時(shí)，這個(gè)信號(hào)被發(fā)射。對(duì)于命令操作連接這個(gè)信號(hào)。對(duì)于切換按鈕連接toggled ()信號(hào)。例如：action/app licati on.cpp、chart/chartform.cpp禾R themes/themes.cpp 。bool QActio n:addTo (QWidget * w )虛把這個(gè)這個(gè)操作添加到窗口部件現(xiàn)在操作可以被添加到QToolBar和QPopupMenu 窗口部件中。被添加到菜單條中的操作會(huì)自動(dòng)被顯示為一個(gè)按鈕,被添加到彈出菜單中的操作會(huì)自動(dòng)顯示(如果 w不是QToolBar 或者為一個(gè)菜單項(xiàng)。如果操作被添加成功，addTo ()返回真，否則返回假。QPopupMe

17、nu ，操作將不會(huì)被添加并且將返回假。) 也可以參考 removeFrom ()。acti on/app licati on.cppaction /toggleacti on/toggleact ion.cppchart/chartform.cpp禾R textedit/textedit.cpp。在QActionGroup中被重新實(shí)現(xiàn)。void QActi on:addedTo(QWidgetactio nWidget,QWidgetcontainer )虛保護(hù)當(dāng)它在con ta in er中為這個(gè)操作創(chuàng)建一個(gè)窗口部件時(shí)(actio nWidget )，這個(gè)函數(shù)被addTo ()調(diào)用。void

18、 QActio n:addedTo ( int in dex,QPopupMenu * menu )虛 保護(hù)這是一個(gè)重載成員函數(shù)，提供了方便。它的行為基本上和上面的函數(shù)相同。index的菜單項(xiàng)時(shí)，這個(gè)函數(shù)被當(dāng)它在彈出菜單 me nu中為這個(gè)操作創(chuàng)建一個(gè)索引為addTo ()調(diào)用。Qlcon Set QActio n:ico nSet () const返回操作的圖標(biāo)。詳細(xì)情況請(qǐng)參考“ icon Set ”屬性。bool QAction:isE nabled () const如果操作生效，返回真，否則返回假。詳細(xì)情況請(qǐng)參考"enabled ” 屬性?！皁n ”屬性。bool QActio

19、n:is On () const如果切換操作是開的，返回真，否則返回假。詳細(xì)情況請(qǐng)參考bool QActio n:isToggleActio n () const"toggleAction” 屬性。如果操作是切換操作，返回真，否則返回假。詳細(xì)情況請(qǐng)參考QString QAction:menuText () constQWidget * w )虛返回操作的菜單文本。詳細(xì)情況請(qǐng)參考“ menu Text ”屬性。bool QAction:removeFrom (從窗口部件w中移除操作。如果操作被成功移除，返回真，否則返回假。也可以參考 addTo ()。設(shè)置切換按鈕為開。詳細(xì)情況請(qǐng)參考“

20、 on ”屬性。void QAction:setAccel ( constQKeySequenee & key )虛設(shè)置操作的快捷鍵為 key。詳細(xì)情況請(qǐng)參考 “accel”屬性。void QActio n:setE nabled ( bool )虛槽設(shè)置操作是否生效。詳細(xì)情況請(qǐng)參考“ enabled ”屬性。void QActio n:setlco nSet ( constQlconSet & )虛設(shè)置操作的圖標(biāo)。詳細(xì)情況請(qǐng)參考“ icon Set ”屬性。void QActio n:setMe nu Text ( constQString & )虛設(shè)置操作的菜單文本

21、。詳細(xì)情況請(qǐng)參考“ menu Text ”屬性。void QActio n:set On ( bool )void QActio n:setStatusTi p ( constQString & )虛QString & )虛設(shè)置操作的狀態(tài)提示。詳細(xì)情況請(qǐng)參考“ statusTip ”屬性。void QAction:setText ( const設(shè)置操作的描述文本。詳細(xì)情況請(qǐng)參考“text ”屬性。void QActio n:setToggleActio n ( bool )設(shè)置操作是否是切換按鈕。詳細(xì)情況請(qǐng)參考“toggleAction” 屬性。QString & )虛

22、void QActio n:setToolT ip ( const設(shè)置操作的工具提示。詳細(xì)情況請(qǐng)參考“toolTip ” 屬性。QString & )虛void QActio n:setWhatsThis ( const設(shè)置操作的“這是什么？”幫助文本。詳細(xì)情況請(qǐng)參考“whatsThis ” 屬性。QString QAction:statusTip () const返回操作的狀態(tài)提示。詳細(xì)情況請(qǐng)參考“ statusTip ”屬性。QString QAction:text () const返回操作的描述文本。詳細(xì)情況請(qǐng)參考“text ”屬性。void QActio n:toggle ()

23、槽切換切換按鈕的狀態(tài)。也可以參考 on、toggled ()和 toggleAction 。void QAction:toggled ( bool )信號(hào)當(dāng)切換按鈕改變狀態(tài)時(shí)，這個(gè)信號(hào)被發(fā)射，命令操作和QActionGroups不發(fā)射toggled ()。參數(shù)表示新的狀態(tài)，也就是如果切換按鈕被打開，為真，或者如果它被關(guān)閉，為假。依賴切換按鈕是否被打開或者關(guān)閉來觸發(fā)用戶命令要把它連接到一個(gè)可以得到bool變量來識(shí)別狀態(tài)的槽，例如: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。實(shí)例：action/toggleact ion /toggleact ion.cppQString QAction:toolTip () const返回操作的工具提示。詳細(xì)情況請(qǐng)參考“toolTip ” 屬性。QString QAct

25、ion:whatsThis () const返回操作的“這是什么？”幫助文本。詳細(xì)情況請(qǐng)參考“whatsThis ” 屬性。屬性文檔QKeySequence accel這個(gè)屬性保存的是操作的快捷鍵。鍵代碼可以在 Qt:Key 和 Qt:Modifier 中找到。這里沒有默認(rèn)快捷鍵。通過 setAccel () 設(shè)置屬性值并且通過 accel ()來獲得屬性值。bool enabled這個(gè)屬性保存的是操作是否生效。失效的操作不能被用戶選擇。它們不從菜單 / 工具條上消失，但是會(huì)以某種方式表面它們不可用，例如，它們也許被變灰。失效操作上的“這是什么？”幫助還是由被設(shè)置的QAction:whatsT

26、his 屬性提供。通過 setEnabled ()設(shè)置屬性值并且通過 isEnabled ()來獲得到屬性值。QIconSet iconSet這個(gè)屬性保存的是操作的圖標(biāo)。實(shí)例。)這個(gè)圖標(biāo)會(huì)用在工具條按鈕和菜單中菜單文本的左面。這里沒有默認(rèn)圖標(biāo)。請(qǐng)參考 action/toggleaction/toggleaction.cpp通過 setIconSet ()設(shè)置屬性值并且通過 iconSet () 來獲得屬性值。QString menuText這個(gè)屬性保存的是操作的菜單文本。如果操作備添加為菜單中的一個(gè)菜單選項(xiàng)將會(huì)由圖標(biāo)如果有的話) 、菜單文本和快捷鍵 (如setMenuText () 中明確設(shè)置

27、， 操作果有的話) 組成。 如果沒有菜單文本在構(gòu)造函數(shù)或者使用 的描述文本將用來作為菜單文本。這里沒有默認(rèn)菜單文本。也可以參考 text 。通過 setMenuText () 設(shè)置屬性值并且通過 menuText ()來獲得屬性值。bool on這個(gè)屬性保存的是切換按鈕是否為開。對(duì)于命令操作和 QActionGroup 這個(gè)屬性總是開的(真) ， setOn ()對(duì)于它們沒有效果。對(duì)于為真的操作，這個(gè)屬性的默認(rèn)值是關(guān)(假) 。也可以參考 toggleAction 。通過 setOn ()設(shè)置屬性值并且通過 isOn () 來獲得屬性值。QString statusTip這個(gè)屬性保存的是操作的狀態(tài)提示。這個(gè)狀態(tài)提示將會(huì)被顯示在操作的頂級(jí)父窗口部件提供的所有狀態(tài)條上。如果沒有狀態(tài)提示被定義，操作使用工具條提示文本。這里沒有默認(rèn)的狀態(tài)提示。也可以參考 statusTip 和 toolTip 。通過 setStatusTip ()設(shè)置屬