📄 qdockwindow.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/qdockwindow.cpp:664 -->
<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>QDockWindow类</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>QDockWindow类参考</h1>
<p>QDockWindow类提供了可以被锚接入QDockArea或者作为顶级窗口在桌面上浮动的窗口部件。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qdockwindow-h.html">qdockwindow.h</a>></tt>
<p>继承了<a href="qframe.html">QFrame</a>。
<p>被<a href="qtoolbar.html">QToolBar</a>继承。
<p><a href="qdockwindow-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn>enum <a href="#Place-enum"><b>Place</b></a> { InDock, OutsideDock }</div></li>
<li><div class=fn>enum <a href="#CloseMode-enum"><b>CloseMode</b></a> { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked }</div></li>
<li><div class=fn><a href="#QDockWindow"><b>QDockWindow</b></a> ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 )</div></li>
<li><div class=fn>virtual void <a href="#setWidget"><b>setWidget</b></a> ( QWidget * w )</div></li>
<li><div class=fn>QWidget * <a href="#widget"><b>widget</b></a> () const</div></li>
<li><div class=fn>Place <a href="#place"><b>place</b></a> () const</div></li>
<li><div class=fn>QDockArea * <a href="#area"><b>area</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setCloseMode"><b>setCloseMode</b></a> ( int m )</div></li>
<li><div class=fn>bool <a href="#isCloseEnabled"><b>isCloseEnabled</b></a> () const</div></li>
<li><div class=fn>int <a href="#closeMode"><b>closeMode</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setResizeEnabled"><b>setResizeEnabled</b></a> ( bool b )</div></li>
<li><div class=fn>virtual void <a href="#setMovingEnabled"><b>setMovingEnabled</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#isResizeEnabled"><b>isResizeEnabled</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isMovingEnabled"><b>isMovingEnabled</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setHorizontallyStretchable"><b>setHorizontallyStretchable</b></a> ( bool b )</div></li>
<li><div class=fn>virtual void <a href="#setVerticallyStretchable"><b>setVerticallyStretchable</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#isHorizontallyStretchable"><b>isHorizontallyStretchable</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isVerticallyStretchable"><b>isVerticallyStretchable</b></a> () const</div></li>
<li><div class=fn>void setHorizontalStretchable ( bool b ) <em>(obsolete)</em></div></li>
<li><div class=fn>void setVerticalStretchable ( bool b ) <em>(obsolete)</em></div></li>
<li><div class=fn>bool isHorizontalStretchable () const <em>(obsolete)</em></div></li>
<li><div class=fn>bool isVerticalStretchable () const <em>(obsolete)</em></div></li>
<li><div class=fn>bool <a href="#isStretchable"><b>isStretchable</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setOffset"><b>setOffset</b></a> ( int o )</div></li>
<li><div class=fn>int <a href="#offset"><b>offset</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setFixedExtentWidth"><b>setFixedExtentWidth</b></a> ( int w )</div></li>
<li><div class=fn>virtual void <a href="#setFixedExtentHeight"><b>setFixedExtentHeight</b></a> ( int h )</div></li>
<li><div class=fn>QSize <a href="#fixedExtent"><b>fixedExtent</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setNewLine"><b>setNewLine</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#newLine"><b>newLine</b></a> () const</div></li>
<li><div class=fn>Qt::Orientation <a href="#orientation"><b>orientation</b></a> () const</div></li>
<li><div class=fn>QBoxLayout * <a href="#boxLayout"><b>boxLayout</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setOpaqueMoving"><b>setOpaqueMoving</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#opaqueMoving"><b>opaqueMoving</b></a> () const</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>virtual void <a href="#undock"><b>undock</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#dock"><b>dock</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setOrientation"><b>setOrientation</b></a> ( Orientation o )</div></li>
</ul>
<h2>信号</h2>
<ul>
<li><div class=fn>void <a href="#orientationChanged"><b>orientationChanged</b></a> ( Orientation o )</div></li>
<li><div class=fn>void <a href="#placeChanged"><b>placeChanged</b></a> ( QDockWindow::Place p )</div></li>
<li><div class=fn>void <a href="#visibilityChanged"><b>visibilityChanged</b></a> ( bool visible )</div></li>
</ul>
<h2>属性</h2>
<ul>
<li><div class=fn>int <a href="#closeMode-prop"><b>closeMode</b></a> - 锚接窗口的关闭模式</div></li>
<li><div class=fn>bool <a href="#horizontallyStretchable-prop"><b>horizontallyStretchable</b></a> - 锚接窗口水平方向上可否延伸</div></li>
<li><div class=fn>bool <a href="#movingEnabled-prop"><b>movingEnabled</b></a> - 用户可不可以在锚接区域内移动锚接窗口、把锚接窗口移动到其他锚接区域、或者浮动锚接窗口</div></li>
<li><div class=fn>bool <a href="#newLine-prop"><b>newLine</b></a> - 锚接窗口是否更愿意在锚接区域中新开一行</div></li>
<li><div class=fn>int <a href="#offset-prop"><b>offset</b></a> - 锚接窗口对于锚接区域的左边界（对于垂直锚接区域是上边界）首选的位移</div></li>
<li><div class=fn>bool <a href="#opaqueMoving-prop"><b>opaqueMoving</b></a> - 在锚接窗口正在被移动的时候，锚接窗口是否将被正常显示</div></li>
<li><div class=fn>Place <a href="#place-prop"><b>place</b></a> - 锚接窗口是否在锚接区域中 <em>（只读）</em></div></li>
<li><div class=fn>bool <a href="#resizeEnabled-prop"><b>resizeEnabled</b></a> - 锚接窗口是否是可以重新定义大小的</div></li>
<li><div class=fn>bool <a href="#stretchable-prop"><b>stretchable</b></a> - 锚接窗口在当前的orientation()上是否是可延伸的 <em>（只读）</em></div></li>
<li><div class=fn>bool <a href="#verticallyStretchable-prop"><b>verticallyStretchable</b></a> - 锚接窗口垂直方向上可否延伸</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
<p>QDockWindow类提供了可以被锚接入<a href="qdockarea.html">QDockArea</a>或者作为顶级窗口在桌面上浮动的窗口部件。
<p>
<p> 这个类处理锚接窗口的移动、重定义大小、锚接和取消锚接。<a href="qtoolbar.html">QToolBar</a>是QDockWindow的一个子类，所以提供给锚接窗口的功能对于工具条的相同应用编程接口也是可用的。
<p> <center><img src="qmainwindow-qdockareas.png" alt="QDockWindows in a QDockArea"></center> <blockquote><p align="center"><em> 在<a href="qdockarea.html">QDockArea</a>中的两个QDockWindow（<a href="qtoolbar.html">QToolBar</a>）
</em></p>
</blockquote><p> <center><img src="qdockwindow.png" alt="A QDockWindow"></center> <blockquote><p align="center"><em> 一个浮动的QDockWindow
</em></p>
</blockquote><p> 如果用户把锚接窗口拖动到锚接区域中，锚接窗口将被锚接。如果用户锚接窗口拖动到任何锚接窗口外面，锚接窗口将被取消锚接（也就是被浮动）并且变为一个顶级窗口。双击浮动的锚接窗口的标题栏将会把锚接窗口锚接到它最近一次被锚接的地方。双击被锚接的锚接窗口句柄将取消锚接窗口的锚接（也就是浮动起来）。单击被锚接的锚接窗口句柄将最小化这个锚接窗口（只有它的句柄被显示，在菜单条下面）。单击最小化句柄将会把锚接窗口恢复到最近一次被锚接的地方。如果用户点击关闭按钮（默认情况下会出现在浮动的锚接窗口上），锚接窗口将会消失。你可以通过<a href="#setCloseMode">setCloseMode</a>()控制锚接窗口是否有一个关闭按钮。
<p> <a href="qmainwindow.html">QMainWindow</a>提供四个可以用来锚接窗口的锚接区域（上、下、左、右）。对于一些应用程序使用这些QMainWindow提供的锚接区域将是足够的。（如果你想创建你自己的锚接区域，请参考<a href="qdockarea.html">QDockArea</a>文档。）在QMainWindow中右键单击弹出菜单（锚接窗口菜单）是可以用来列出锚接窗口的列表的并且可以用来显示或者隐藏它们。
<p> 当你构造一个锚接窗口时，如果你想它被锚接的话，你<em>必须</em>把<a href="qdockarea.html">QDockArea</a>或者QMainWindow传递给它作为父对象。如果你想它被浮动，就传递0给它作为父对象。
<p> <pre>
<a href="qtoolbar.html">QToolBar</a> *fileTools = new <a href="qtoolbar.html">QToolBar</a>( this, "File Actions" );
moveDockWindow( fileTools, Left );
</pre>
<p> 在上述的实例中，你在一个QMainWindow的子类的构造函数中创建一个新的<a href="qtoolbar.html">QToolBar</a>（所以<em>this</em>指针指向<a href="qmainwindow.html">QMainWindow</a>）。默认情况下，这个工具条将被添加到<a href="qt.html#Dock-enum">Top</a>锚接区域，但是我们已经把它移动到<a href="qt.html#Dock-enum">Left</a>锚接区域了。
<p> 锚接窗口通常用于包含一个单一的窗口部件。在这些情况下，这个窗口部件可以通过调用<a href="#setWidget">setWidget</a>()来被设置。如果你正在构造一个包含多个窗口部件的锚接窗口，例如一个工具条把窗口部件排列在锚接窗口的盒子布局中。为了做到这点，请使用<a href="#boxLayout">boxLayout</a>()函数来获得锚接窗口的盒子布局，然后使用盒子布局的<a href="qboxlayout.html#addWidget">QBoxLayout::addWidget</a>()函数来把窗口部件添加到这个布局中。锚接窗口将会按需要动态地设置布局的方向为水平或者垂直，尽管你可以通过<a href="#setOrientation">setOrientation</a>()来自己控制它。
<p> 尽管锚接窗口的通常用途是为了工具条，它们可以被用于任何窗口部件。（对于实例，请参考<i>Qt设计器</i>和<i>Qt语言学家</i>应用程序。）当使用更大的窗口部件，它可以通过调用<a href="#setResizeEnabled">setResizeEnabled</a>()来告诉锚接窗口可以被重新定义大小。可重新定义大小的锚接窗口是给定像分割句柄来允许用户在它们的锚接区域中重新定义它们的大小。当可重新定义大小的锚接窗口被取消锚接，它们变为顶级窗口并且可以像其它顶级窗口被重新定义大小，例如通过拖动角或者边缘来实现。
<p> 锚接窗口可以使用<a href="#dock">dock</a>()和<a href="#undock">undock</a>()来被锚接和取消锚接。锚接窗口的方向可以使用setOrientation()来设置。你也可以使用<a href="qdockarea.html#moveDockWindow">QDockArea::moveDockWindow</a>()。如果你正在使用一个<a href="qmainwindow.html">QMainWindow</a>，<a href="qmainwindow.html#moveDockWindow">QMainWindow::moveDockWindow</a>()和<a href="qmainwindow.html#removeDockWindow">QMainWindow::removeDockWindow</a>()是可用的。
<p> 锚接窗口有一些首选设置，例如，你可以使用<a href="#setOffset">setOffset</a>()设置从锚接区域的左边界（对于垂直锚接区域是上边界）开始的首选位移。如果你喜欢锚接窗口当它被锚接时开始一个新<a href="qdockarea.html#lines">行</a>，请使用<a href="#setNewLine">setNewLine</a>()。<a href="#setFixedExtentWidth">setFixedExtentWidth</a>()和<a href="#setFixedExtentHeight">setFixedExtentHeight</a>()函数可以用来定义锚接窗口的首选大小，并且<a href="#setHorizontallyStretchable">setHorizontallyStretchable</a>()和<a href="#setVerticallyStretchable">setVerticallyStretchable</a>()函数设置锚接窗口是否可以被延伸。默认情况下锚接窗口可以被移动，但是这个可以通过<a href="#setMovingEnabled">setMovingEnabled</a>()来改变。当锚接窗口被移动时，它被显示唯一个矩形边界，但是使用<a href="#setOpaqueMoving">setOpaqueMoving</a>()它可以被正常地显示。
<p> 当锚接窗口的可视性发生改变，也就是它被显示或者隐藏，<a href="#visibilityChanged">visibilityChanged</a>() 信号被发射。当锚接窗口被锚接或者取消锚接时，<a href="#placeChanged">placeChanged</a>()信号被发射。
<p> <p>也可以参考<a href="application.html">主窗口和相关类</a>。
<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="CloseMode-enum"></a>QDockWindow::CloseMode</h3>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -