?? qtoolbutton.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/qtoolbutton.cpp:74 -->
<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>QToolButton類</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>QToolButton類參考</h1>
<p> QToolButton類提供了用于命令或者選項的可以快速訪問的按鈕，通常可以用在QToolBar里面。
<a href="#details">詳情請見……</a>
<p><tt>#include <<a href="qtoolbutton-h.html">qtoolbutton.h</a>></tt>
<p>繼承了<a href="qbutton.html">QButton</a>。
<p><a href="qtoolbutton-members.html">所有成員函數的列表。</a>
<h2>公有成員</h2>
<ul>
<li><div class=fn><a href="#QToolButton"><b>QToolButton</b></a> ( QWidget * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#QToolButton-2"><b>QToolButton</b></a> ( const QIconSet & iconSet, const QString & textLabel, const QString & grouptext, QObject * receiver, const char * slot, QToolBar * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#QToolButton-3"><b>QToolButton</b></a> ( ArrowType type, QWidget * parent, const char * name = 0 )</div></li>
<li><div class=fn><a href="#~QToolButton"><b>~QToolButton</b></a> ()</div></li>
<li><div class=fn>void setOnIconSet ( const QIconSet & ) <em>（廢棄）</em></div></li>
<li><div class=fn>void setOffIconSet ( const QIconSet & ) <em>（廢棄）</em></div></li>
<li><div class=fn>void setIconSet ( const QIconSet & set, bool on ) <em>（廢棄）</em></div></li>
<li><div class=fn>QIconSet onIconSet () const <em>（廢棄）</em></div></li>
<li><div class=fn>QIconSet offIconSet () const <em>（廢棄）</em></div></li>
<li><div class=fn>QIconSet iconSet ( bool on ) const <em>（廢棄）</em></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>bool <a href="#usesBigPixmap"><b>usesBigPixmap</b></a> () const</div></li>
<li><div class=fn>bool <a href="#usesTextLabel"><b>usesTextLabel</b></a> () const</div></li>
<li><div class=fn>QString <a href="#textLabel"><b>textLabel</b></a> () const</div></li>
<li><div class=fn>void <a href="#setPopup"><b>setPopup</b></a> ( QPopupMenu * popup )</div></li>
<li><div class=fn>QPopupMenu * <a href="#popup"><b>popup</b></a> () const</div></li>
<li><div class=fn>void <a href="#setPopupDelay"><b>setPopupDelay</b></a> ( int delay )</div></li>
<li><div class=fn>int <a href="#popupDelay"><b>popupDelay</b></a> () const</div></li>
<li><div class=fn>void <a href="#openPopup"><b>openPopup</b></a> ()</div></li>
<li><div class=fn>void <a href="#setAutoRaise"><b>setAutoRaise</b></a> ( bool enable )</div></li>
<li><div class=fn>bool <a href="#autoRaise"><b>autoRaise</b></a> () const</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>virtual void <a href="#setUsesBigPixmap"><b>setUsesBigPixmap</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setUsesTextLabel"><b>setUsesTextLabel</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setTextLabel-2"><b>setTextLabel</b></a> ( const QString & newLabel, bool tipToo )</div></li>
<li><div class=fn>virtual void <a href="#setToggleButton"><b>setToggleButton</b></a> ( bool enable )</div></li>
<li><div class=fn>virtual void <a href="#setOn"><b>setOn</b></a> ( bool enable )</div></li>
<li><div class=fn>void <a href="#toggle"><b>toggle</b></a> ()</div></li>
<li><div class=fn>void <a href="#setTextLabel"><b>setTextLabel</b></a> ( const QString & )</div></li>
</ul>
<h2>屬性</h2>
<ul>
<li><div class=fn>bool <a href="#autoRaise-prop"><b>autoRaise</b></a> - 自動浮起是否生效</div></li>
<li><div class=fn>QIconSet <a href="#iconSet-prop"><b>iconSet</b></a> - 提供顯示在按鈕上的圖標的圖標集</div></li>
<li><div class=fn>QIconSet offIconSet - 當按鈕在“關”狀態時使用的圖標集 <em>（廢棄）</em></div></li>
<li><div class=fn>bool <a href="#on-prop"><b>on</b></a> - 工具按鈕是否為開</div></li>
<li><div class=fn>QIconSet onIconSet - 當按鈕在“開”狀態時使用的圖標集 <em>（廢棄）</em></div></li>
<li><div class=fn>int <a href="#popupDelay-prop"><b>popupDelay</b></a> - 在按下按鈕和出現關聯的彈出按鈕之間的以毫秒為單位的時間</div></li>
<li><div class=fn>QString <a href="#textLabel-prop"><b>textLabel</b></a> - 按鈕的標簽</div></li>
<li><div class=fn>bool <a href="#toggleButton-prop"><b>toggleButton</b></a> - 工具按鈕是否是切換按鈕</div></li>
<li><div class=fn>bool <a href="#usesBigPixmap-prop"><b>usesBigPixmap</b></a> - 工具按鈕是否使用大的像素映射</div></li>
<li><div class=fn>bool <a href="#usesTextLabel-prop"><b>usesTextLabel</b></a> - 工具按鈕是否在按鈕像素映射下方顯示標簽</div></li>
</ul>
<h2>保護成員</h2>
<ul>
<li><div class=fn>bool <a href="#uses3D"><b>uses3D</b></a> () const</div></li>
</ul>
<hr><a name="details"></a><h2>詳細描述</h2>
<p> QToolButton類提供了用于命令或者選項的可以快速訪問的按鈕，通常可以用在<a href="qtoolbar.html">QToolBar</a>里面。
<p>
<p> 工具按鈕是提供對特定命令或者選項快速訪問的特殊按鈕。和普通的命令按鈕不同，工具按鈕通常不顯示文本標簽，而是圖標。它的經典用法事選擇工具，例如在一個繪圖程序中的“筆”工具。這個被QToolButton作為切換按鈕重新實現。（請參考<a href="#setToggleButton">setToggleButton</a>()）。
<p> QToolButton支持自動浮起。在自動浮起模式中，按鈕只有在鼠標指向它的時候才繪制三維的框架。當按鈕被用在QToolBar里面的時候，這個特征會自動被啟用。可以使用<a href="#setAutoRaise">setAutoRaise</a>()來改變它。
<p> 工具按鈕的圖標是被設置為<a href="qiconset.html">QIconSet</a>。這使得它可以為失效和激活狀態指定不同的像素映射。當按鈕的功能不可用的時候，失效的像素映射被使用。當因為用戶用鼠標指向按鈕而自動浮起時，激活的像素映射被顯示。
<p> 按鈕的外觀和尺寸可以通過<a href="#setUsesBigPixmap">setUsesBigPixmap</a>()和<a href="#setUsesTextLabel">setUsesTextLabel</a>()來調節。當被用在<a href="qtoolbar.html">QToolBar</a>里面時，按鈕會自動地調節來適合<a href="qmainwindow.html">QMainWindow</a>的設置（請參考<a href="qmainwindow.html#setUsesTextLabel">QMainWindow::setUsesTextLabel</a>()和<a href="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>()）。
<p> 工具按鈕可以提供一個彈出菜單的額外選擇。這個特征有時對于網頁瀏覽器中的“后退”按鈕是有用的。在按下按鈕一段時間之后，一個菜單會彈出來顯示所有可以后退瀏覽的可能頁面。你可以使用<a href="#setPopup">setPopup</a>()來為QToolButton設置一個彈出菜單。默認延時是600毫秒，你可以使用<a href="#setPopupDelay">setPopupDelay</a>()來調節它。
<p> <center><img src="qdockwindow.png" alt="Toolbar with Toolbuttons"></center> <blockquote><p align="center"><em> 一個有QToolbutton的浮動的QToolbar
</em></p>
</blockquote><p> <p>也可以參考<a href="qpushbutton.html">QPushButton</a>、<a href="qtoolbar.html">QToolBar</a>、<a href="qmainwindow.html">QMainWindow</a>、<a href="guibooks.html#fowler">圖形用戶界面設計手冊：推動按鈕</a>和<a href="basic.html">基本窗口部件</a>。
<hr><h2>成員函數文檔</h2>
<h3 class=fn><a name="QToolButton"></a>QToolButton::QToolButton ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
</h3>
構造一個父對象為<em>parent</em>并且名稱為<em>name</em>的空工具按鈕。
<h3 class=fn><a name="QToolButton-2"></a>QToolButton::QToolButton ( const <a href="qiconset.html">QIconSet</a> & iconSet, const <a href="qstring.html">QString</a> & textLabel, const <a href="qstring.html">QString</a> & grouptext, <a href="qobject.html">QObject</a> * receiver, const char * slot, <a href="qtoolbar.html">QToolBar</a> * parent, const char * name = 0 )
</h3>
構造一個父對象為<em>parent</em>（必須為<a href="qtoolbar.html">QToolBar</a>）并且名稱為<em>name</em>的工具按鈕。
<p> 工具按鈕將顯示<em>iconSet</em>，它的文本標簽和工具提示設置為<em>textLabel</em>并且它的狀態條信息設置為<em>grouptext</em>。它將被連接到<em>receiver</em>對象的<em>slot</em>槽。
<h3 class=fn><a name="QToolButton-3"></a>QToolButton::QToolButton ( <a href="qt.html#ArrowType-enum">ArrowType</a> type, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )
</h3>
把工具按鈕構造為箭頭按鈕。ArrowType <em>type</em>定義了箭頭的方向。可用的值為LeftArrow、RightArrow、UpArrow和DownArrow。
<p> 箭頭按鈕的自動重復默認是打開的。
<p> <em>parent</em>和<em>name</em>參數被發送給<a href="qwidget.html">QWidget</a>構造函數。
<h3 class=fn><a name="~QToolButton"></a>QToolButton::~QToolButton ()
</h3>
銷毀這個對象并且釋放任何被分配的資源。
<h3 class=fn>bool <a name="autoRaise"></a>QToolButton::autoRaise () const
</h3>
<p>如果自動浮起有效，返回真，否則返回假。詳細情況請參考<a href="qtoolbutton.html#autoRaise-prop">“autoRaise”</a>屬性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet"></a>QToolButton::iconSet () const
</h3>
<p>返回提供顯示在按鈕上的圖標的圖標集。詳細情況請參考<a href="qtoolbutton.html#iconSet-prop">“iconSet”</a>屬性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="iconSet-2"></a>QToolButton::iconSet ( bool on ) const
</h3>
這是一個重載成員函數，提供了方便。它的行為基本上和上面的函數相同。
<p> <b>這個函數是廢棄的。</b>它的提供只是為了保證舊代碼能夠工作。我們強烈建議在新代碼中不要使用它。
<p> 從Qt 3.0開始，<a href="qiconset.html">QIconSet</a>可以包含開和關兩套圖標了。
<p> 為了方便移植，這個函數將忽略<em>on</em>參數并且返回<a href="#iconSet-prop">iconSet</a>屬性。如果你依賴于<em>on</em>參數，你也許要把你的代碼升級到QIconSet開/關機制了。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="offIconSet"></a>QToolButton::offIconSet () const
</h3>
<p>返回當按鈕在“關”狀態下被使用的圖標集。詳細情況請參考<a href="qtoolbutton.html#offIconSet-prop">“offIconSet”</a>屬性。
<h3 class=fn><a href="qiconset.html">QIconSet</a> <a name="onIconSet"></a>QToolButton::onIconSet () const
</h3>
<p>返回當按鈕在“開”狀態下被使用的圖標集。詳細情況請參考<a href="qtoolbutton.html#onIconSet-prop">“onIconSet”</a>屬性。
<h3 class=fn>void <a name="openPopup"></a>QToolButton::openPopup ()
</h3>
打開（彈出）關聯的彈出菜單。如果沒有這樣的菜單，這個函數就什么也不做。直到這個彈出菜單已經被用戶關閉，這個函數才會返回。
<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a> * <a name="popup"></a>QToolButton::popup () const
</h3>
返回關聯的彈出菜單，或者如果沒有定義彈出菜單，返回0。
<p> <p>也可以參考<a href="#setPopup">setPopup</a>()。
<h3 class=fn>int <a name="popupDelay"></a>QToolButton::popupDelay () const
</h3>
<p>返回在按下按鈕和出現關聯的彈出按鈕之間的以毫秒為單位的時間。詳細情況請參考<a href="qtoolbutton.html#popupDelay-prop">“popupDelay”</a>屬性。
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -