📄 qdockarea.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/qdockarea.cpp:458 -->
<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>QDockArea类</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>QDockArea类参考</h1>
<p>QDockArea类管理和布局QDockWindow。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qdockarea-h.html">qdockarea.h</a>></tt>
<p>继承了<a href="qwidget.html">QWidget</a>。
<p><a href="qdockarea-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn>enum <a href="#HandlePosition-enum"><b>HandlePosition</b></a> { Normal, Reverse }</div></li>
<li><div class=fn><a href="#QDockArea"><b>QDockArea</b></a> ( Orientation o, HandlePosition h = Normal, QWidget * parent = 0, const char * name = 0 )</div></li>
<li><div class=fn><a href="#~QDockArea"><b>~QDockArea</b></a> ()</div></li>
<li><div class=fn>void <a href="#moveDockWindow-2"><b>moveDockWindow</b></a> ( QDockWindow * w, const QPoint & p, const QRect & r, bool swap )</div></li>
<li><div class=fn>void <a href="#removeDockWindow"><b>removeDockWindow</b></a> ( QDockWindow * w, bool makeFloating, bool swap, bool fixNewLines = TRUE )</div></li>
<li><div class=fn>void <a href="#moveDockWindow"><b>moveDockWindow</b></a> ( QDockWindow * w, int index = -1 )</div></li>
<li><div class=fn>bool <a href="#hasDockWindow"><b>hasDockWindow</b></a> ( QDockWindow * w, int * index = 0 )</div></li>
<li><div class=fn>Orientation <a href="#orientation"><b>orientation</b></a> () const</div></li>
<li><div class=fn>HandlePosition <a href="#handlePosition"><b>handlePosition</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isEmpty"><b>isEmpty</b></a> () const</div></li>
<li><div class=fn>int <a href="#count"><b>count</b></a> () const</div></li>
<li><div class=fn>QPtrList<QDockWindow> <a href="#dockWindowList"><b>dockWindowList</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isDockWindowAccepted"><b>isDockWindowAccepted</b></a> ( QDockWindow * dw )</div></li>
<li><div class=fn>void <a href="#setAcceptDockWindow"><b>setAcceptDockWindow</b></a> ( QDockWindow * dw, bool accept )</div></li>
</ul>
<h2>公有槽</h2>
<ul>
<li><div class=fn>void <a href="#lineUp"><b>lineUp</b></a> ( bool keepNewLines )</div></li>
</ul>
<h2>属性</h2>
<ul>
<li><div class=fn>int <a href="#count-prop"><b>count</b></a> - 锚接区域中的锚接窗口的数量 <em>（只读）</em></div></li>
<li><div class=fn>bool <a href="#empty-prop"><b>empty</b></a> - 锚接区域是否为空 <em>（只读）</em></div></li>
<li><div class=fn>HandlePosition <a href="#handlePosition-prop"><b>handlePosition</b></a> - 锚接窗口的分隔句柄被放在锚接区域的哪里 <em>（只读）</em></div></li>
<li><div class=fn>Orientation <a href="#orientation-prop"><b>orientation</b></a> - 锚接区域的方向 <em>（只读）</em></div></li>
</ul>
<h2>相关函数</h2>
<ul>
<li><div class=fn>QTextStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QTextStream & ts, const QDockArea & dockArea )</div></li>
<li><div class=fn>QTextStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QTextStream & ts, QDockArea & dockArea )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
<p>QDockArea类管理和布局QDockWindow。
<p>
<p> QDockArea是一个管理QDockWindow的列表，把它们布局在它的区域中的一个容器。在和QDockWindow的合作当中，它负责QDockWindow的锚接和取消锚接并且在锚接区域中移动它们。QDockArea也处理QDockWindow的自动换行来填充尽可能紧密的可用空间。QDockArea可以包含QToolBar，因为<a href="qtoolbar.html">QToolBar</a>是<a href="qdockwindow.html">QDockWindow</a>的一个子类。
<p> <a href="qmainwindow.html">QMainWindow</a>包含四个你可以使用你的QToolBar和QDockWindow的QDockArea，所以在绝大多数情况下，你不需要直接使用QDockArea类。尽管QMainWindow包含了它自己的锚接区域，但是对于添加新的QDockArea它是不方便的。如果你需要创建你自己的锚接区域，我们建议你创建<a href="qwidget.html">QWidget</a>的一个子类并且把你的QDockArea添加到你的子类中。
<p> <center><img src="qmainwindow-qdockareas.png" alt="QMainWindow's QDockAreas"></center>
<p> <a name="lines"></a>
<em>行</em>。QDockAre使用行的概念。一行就是可以并排地包含锚接窗口的一个水平区域。一个锚接区域可以拥有比一行更多的空间。当锚接窗口被锚接到一个锚接区域中时，它们通常被添加到这个空间中最上面一行的最右侧（除了是由用户手工放置的）。当用户移动锚接窗口时，它们可以离开空白行或者放入非空行的空隙中。使用<a href="#lineUp">lineUp</a>()函数，锚接窗口可以被按行排序来使浪费的空间最小化。
<p> QDockArea类维护着所有它的子锚接窗口的位置列表。被添加到锚接区域的锚接窗口是从0开始的。锚接窗口被按从左到右的顺序布局，并且对于多行的锚接窗口，是从上到下。如果一个锚接窗口被浮动起来，它还保持着它的位置，因为如果用户双击它的标题，它会返回它原来的位置。锚接窗口的位置可以被<a href="#hasDockWindow">hasDockWindow</a>()决定。位置可以被<a href="#moveDockWindow">moveDockWindow</a>()改变。
<p> 使用<a href="qdockwindow.html#dock">QDockWindow::dock</a>()和<a href="qdockwindow.html#undock">QDockWindow::undock</a>()可以分别锚接一个锚接窗口或者取消锚接一个锚接窗口。如果你想控制哪个锚接窗口可以锚接在一个锚接区域中请使用<a href="#setAcceptDockWindow">setAcceptDockWindow</a>()。为了查看一个锚接区域是否有一个特定锚接窗口请使用<a href="#hasDockWindow">hasDockWindow</a>()，为了查看一个锚接区域中包含多少个锚接窗口请使用<a href="#count">count</a>()。
<p> 流操作符可以把锚接区域中的锚接窗口的位置写到<a href="qtextstream.html">QTextStream</a>中。这些位置也可以在这之后被读出来恢复被保存的位置。
<p> 把位置存储到QTextStream中。
<pre>
ts << *myDockArea;
</pre>
<p> 从QTextStream中恢复位置：
<pre>
ts >> *myDockArea;
</pre>
<p> <p>也可以参考<a href="application.html">主窗口和相关类</a>。
<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="HandlePosition-enum"></a>QDockArea::HandlePosition</h3>
<p> 锚接窗口有两种句柄，锚接窗口句柄用于拖动锚接窗口，并且分隔句柄用于使用一个分隔符和其它锚接窗口的关系中来重新定义锚接窗口的大小。
<p> 这个枚举变量指定了锚接窗口分割句柄被放置到锚接区域的哪里。
<ul>
<li><tt>QDockArea::Normal</tt> - 锚接窗口的分割句柄被放置到右面或者下面。
<li><tt>QDockArea::Reverse</tt> - 锚接窗口的分割句柄被放置到左面或者上面。
</ul><p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -