?? qtoolbar.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/qtoolbar.cpp:214 -->
<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>QToolBar類</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">函數(shù)</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>QToolBar類參考</h1>
<p>QToolBar類提供樂意可以包含工具按鈕這類的窗口部件的可移動的面板。
<a href="#details">詳情請見……</a>
<p><tt>#include <<a href="qtoolbar-h.html">qtoolbar.h</a>></tt>
<p>繼承了<a href="qdockwindow.html">QDockWindow</a>。
<p><a href="qtoolbar-members.html">所有成員函數(shù)的列表。</a>
<h2>公有成員</h2>
<ul>
<li><div class=fn>QToolBar ( const QString & label, QMainWindow *, ToolBarDock = DockTop, bool newLine = FALSE, const char * name = 0 ) <em>(obsolete)</em></div></li>
<li><div class=fn><a href="#QToolBar-2"><b>QToolBar</b></a> ( const QString & label, QMainWindow * mainWindow, QWidget * parent, bool newLine = FALSE, const char * name = 0, WFlags f = 0 )</div></li>
<li><div class=fn><a href="#QToolBar-3"><b>QToolBar</b></a> ( QMainWindow * parent = 0, const char * name = 0 )</div></li>
<li><div class=fn>void <a href="#addSeparator"><b>addSeparator</b></a> ()</div></li>
<li><div class=fn>QMainWindow * <a href="#mainWindow"><b>mainWindow</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setStretchableWidget"><b>setStretchableWidget</b></a> ( QWidget * w )</div></li>
<li><div class=fn>virtual void <a href="#setLabel"><b>setLabel</b></a> ( const QString & )</div></li>
<li><div class=fn>QString <a href="#label"><b>label</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#clear"><b>clear</b></a> ()</div></li>
</ul>
<h2>屬性</h2>
<ul>
<li><div class=fn>QString <a href="#label-prop"><b>label</b></a> - 工具條的標簽</div></li>
</ul>
<hr><a name="details"></a><h2>詳細描述</h2>
<p> QToolBar類提供樂意可以包含工具按鈕這類的窗口部件的可移動的面板。
<p>
<p> 工具條是包含一套控制的面板，通常表現(xiàn)為小圖標。它用于提供常用命令或者選項的快速訪問。在<a href="qmainwindow.html">QMainWindow</a>里面，用戶可以錨接區(qū)域里面或者之間拖動工具條。工具條也可以被拖動出任何錨接區(qū)域而作為頂級窗口自由浮動。
<p> QToolBar是<a href="qdockwindow.html">QDockWindow</a>的特殊化，并且提供QDockWindow的所有功能。
<p> 為了使用QToolBar，你可以簡單的把QToolBar創(chuàng)建為QMainWindow的子對象，從左到右（或者從上到下）創(chuàng)建許多<a href="qtoolbutton.html">QToolButton</a>窗口部件（或者其他窗口部件）并且當你想要一個分隔符，請調(diào)用<a href="#addSeparator">addSeparator</a>()。當工具條被浮動時，標題會使用在構(gòu)造函數(shù)中給定的標簽。這個可以通過<a href="#setLabel">setLabel</a>()來改變。
<p>
<pre> QToolBar * fileTools = new QToolBar( this, "file operations" );
fileTools-><a href="#setLabel">setLabel</a>( "File Operations" );
fileOpenAction-><a href="qaction.html#addTo">addTo</a>( fileTools );
fileSaveAction-><a href="qaction.html#addTo">addTo</a>( fileTools );
</pre>
<p> 這是從<a href="simple-application-example.html">application/application.cpp</a>實例中提取出來的，顯示了把新的工具條創(chuàng)建為<a href="qmainwindow.html">QMainWindow</a>的子對象并且添加兩個QAction。
<p> 你可以在工具條中使用絕大多數(shù)窗口部件，最常用的時QToolButton和<a href="qcombobox.html">QComboBox</a>。
<p> 注意如果你在一個已經(jīng)可視的QToolBar上創(chuàng)建一個新的窗口部件，這個窗口部件可以在沒有明顯調(diào)用<a href="qwidget.html#show">show</a>()的情況下就會自動變?yōu)榭梢暎ㄟ@和Qt中其他窗口部件容器不一樣）。總之，請為你放入可視的QToolBar的所有窗口部件明顯地調(diào)用show()，這個行為也許在未來會被確定下來。
<p> QToolBar，像QDockWindow一樣，可以被定位在QDockArea中或者像頂級窗口一樣浮動。QMainWindow提供了四個QDockArea（上、下、左、右）。當你創(chuàng)建一個新工具條（像上述實例一樣）作為QMainWindow的子對象時，這個工具條會被添加到上面的錨接區(qū)域。你可以通過調(diào)用<a href="qmainwindow.html#moveDockWindow">QMainWindow::moveDockWindow</a>()把它移動到其它錨接區(qū)域（或者浮動起來）。QDockarea在<a href="qdockarea.html#lines">行</a>中布局它們的窗口。
<p> 如果主窗口被重新定義大小，這樣工具條所占的區(qū)域會變小以至于不能顯示所有窗口部件，這時一個小箭頭按鈕（看起來像指向右的V形符號，“»”）將會根據(jù)工具條的方向顯示在工具條的右面或者下面。點擊這個按鈕將會彈出一個菜單來顯示那些“過剩的”項。
<p> 通常工具條將會得到它所需要的空間。可是，通過<a href="qdockwindow.html#setHorizontalStretchable">setHorizontalStretchable</a>()、<a href="qdockwindow.html#setVerticalStretchable">setVerticalStretchable</a>()或
<a href="#setStretchableWidget">setStretchableWidget</a>()，你可以告訴主窗口在指定的方向延伸工具條來填充所有可用的空間。
<p> 工具條在水平方向或者垂直方向（詳細情況請參考<a href="qdockwindow.html#orientation">orientation</a>()）上排列它的按鈕。通常<a href="qdockarea.html">QDockArea</a>將會為你設(shè)置正確的方向，但是你可以使用<a href="qdockwindow.html#setOrientation">setOrientation</a>()來自己設(shè)置它并且通過連接到<a href="qdockwindow.html#orientationChanged">orientationChanged</a>()信號來跟蹤任何變化。
<p> 你可以使用<a href="#clear">clear</a>()方法來移除工具條的所有條目。
<p> <center><img src="qdockwindow.png" alt="Toolbar (dock window)"></center> <blockquote><p align="center"><em> 一個浮動的QToolbar（錨接窗口）
</em></p>
</blockquote><p> <p>也可以參考<a href="qtoolbutton.html">QToolButton</a>、<a href="qmainwindow.html">QMainWindow</a>、<a href="http://www.iarchitect.com/visual.htm">Parts of Isys on Visual Design</a>、<a href="guibooks.html#fowler">圖形用戶界面設(shè)計手冊：工具條</a>和<a href="application.html">主窗口和相關(guān)類</a>。
<hr><h2>成員函數(shù)文檔</h2>
<h3 class=fn><a name="QToolBar"></a>QToolBar::QToolBar ( const <a href="qstring.html">QString</a> & label, <a href="qmainwindow.html">QMainWindow</a> *, ToolBarDock = DockTop, bool newLine = FALSE, const char * name = 0 )
</h3>
<p> <b>這個函數(shù)是廢棄的。</b>它的提供只是為了保證舊代碼能夠工作。我們強烈建議在新代碼中不要使用它。
<h3 class=fn><a name="QToolBar-2"></a>QToolBar::QToolBar ( const <a href="qstring.html">QString</a> & label, <a href="qmainwindow.html">QMainWindow</a> * mainWindow, <a href="qwidget.html">QWidget</a> * parent, bool newLine = FALSE, const char * name = 0, WFlags f = 0 )
</h3>
<p> 構(gòu)造一個空的水平工具條。
<p> 工具條是<em>parent</em>的子對象并且被<em>mainWindow</em>管理。<em>label</em>和<em>newLine</em> 參數(shù)被直接傳遞給<a href="qmainwindow.html#addDockWindow">QMainWindow::addDockWindow</a>()。<em>name</em>是對象名稱并且<em>f</em>是窗口部件標記。
<p> 如果你想創(chuàng)建已經(jīng)取消錨接正在浮動的工具條或者狀態(tài)條中的工具條時請使用這個構(gòu)造函數(shù)。
<h3 class=fn><a name="QToolBar-3"></a>QToolBar::QToolBar ( <a href="qmainwindow.html">QMainWindow</a> * parent = 0, const char * name = 0 )
</h3>
這是一個重載成員函數(shù)，提供了方便。它的行為基本上和上面的函數(shù)相同。
<p> 構(gòu)造一個在<em>parent</em>的上面錨接區(qū)域中的父對象為<em>parent</em>并且名稱為<em>name</em>的空工具條。沒有任何標簽并且不需要一個新行。
<h3 class=fn>void <a name="addSeparator"></a>QToolBar::addSeparator ()
</h3>
在工具條的右面/下面添加一個分隔符。
<p>實例：<a href="canvas-chart-example.html#x2613">chart/chartform.cpp</a>、<a href="fileiconview-example.html#x891">fileiconview/mainwindow.cpp</a>、<a href="helpviewer-example.html#x1036">helpviewer/helpwindow.cpp</a>、<a href="qfd-example.html#x1993">qfd/fontdisplayer.cpp</a>和<a href="scribble-example.html#x964">scribble/scribble.cpp</a>。
<h3 class=fn>void <a name="clear"></a>QToolBar::clear ()<tt> [虛]</tt>
</h3>
刪除工具條的所有子窗口部件。
<h3 class=fn><a href="qstring.html">QString</a> <a name="label"></a>QToolBar::label () const
</h3>
<p>返回工具條的標簽。詳細情況請參考<a href="qtoolbar.html#label-prop">“l(fā)abel”</a>屬性。
<h3 class=fn><a href="qmainwindow.html">QMainWindow</a> * <a name="mainWindow"></a>QToolBar::mainWindow () const
</h3>
返回一個管理這個工具條的<a href="qmainwindow.html">QMainWindow</a>的指針。
<h3 class=fn>void <a name="setLabel"></a>QToolBar::setLabel ( const <a href="qstring.html">QString</a> & )<tt> [虛]</tt>
</h3>
<p>設(shè)置工具條的標簽。詳細情況請參考<a href="qtoolbar.html#label-prop">“l(fā)abel”</a>屬性。
<h3 class=fn>void <a name="setStretchableWidget"></a>QToolBar::setStretchableWidget ( <a href="qwidget.html">QWidget</a> * w )<tt> [虛]</tt>
</h3>
如果這個工具條被需要延伸，設(shè)置窗口部件<em>w</em>被延伸。
<p> 因為<a href="qmainwindow.html">QMainWindow</a>正確調(diào)整它里面的錨接區(qū)域，或者因為這個工具條的<a href="qdockwindow.html#isVerticalStretchable">isVerticalStretchable</a>()或者<a href="qdockwindow.html#isHorizontalStretchable">isHorizontalStretchable</a>()被設(shè)置為真，這個延伸的請求也許會發(fā)生。
<p> 如果你調(diào)用這個函數(shù)并且工具條還不是可延伸的，setStretchable()被調(diào)用。
<p> <p>也可以參考<a href="qmainwindow.html#rightJustification-prop">QMainWindow::rightJustification</a>、<a href="qdockwindow.html#setVerticalStretchable">setVerticalStretchable</a>()和<a href="qdockwindow.html#setHorizontalStretchable">setHorizontalStretchable</a>()。
<p>實例：<a href="fileiconview-example.html#x892">fileiconview/mainwindow.cpp</a>和<a href="helpviewer-example.html#x1037">helpviewer/helpwindow.cpp</a>。
<hr><h2>屬性文檔</h2>
<h3 class=fn><a href="qstring.html">QString</a> <a name="label-prop"></a>label</h3>
<p>這個屬性保存的是工具條的標簽。
<p>如果工具條被浮動，標簽就變?yōu)楣ぞ邨l窗口的標題。這里沒有默認標簽文本。
<p>通過<a href="#setLabel">setLabel</a>()設(shè)置屬性值并且通過<a href="#label">label</a>()來獲得屬性值。
<!-- eof -->
<hr><p>
這個文件是<a href="index.html">Qt工具包</a>一部分。
版權(quán)所有 © 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有權(quán)利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 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>?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -