qdockwindow.html

QT参考文档

<p> 这个枚举变量指定了锚接窗口什么时候有（如果）一个关闭按钮。
<ul>
<li><tt>QDockWindow::Never</tt> - 锚接窗口从没有一个关闭按钮并且不能被用户关闭
<li><tt>QDockWindow::Docked</tt> - 锚接窗口只有在被锚接的时候有一个关闭按钮。
<li><tt>QDockWindow::Undocked</tt> - 锚接窗口只有在浮动的时候有一个关闭按钮。
<li><tt>QDockWindow::Always</tt> - 锚接窗口总是有一个关闭按钮。
</ul><p> 注意如果用户在锚接窗口被锚接时点击它们的锚接窗口句柄，锚接窗口总是被最小化。

<h3 class=fn><a name="Place-enum"></a>QDockWindow::Place</h3>
<p> 这个枚举变量指定了QDockWindow的可能位置：
<ul>
<li><tt>QDockWindow::InDock</tt> - 在一个<a href="qdockarea.html">QDockArea</a>中
<li><tt>QDockWindow::OutsideDock</tt> - 在桌面上作为顶级窗口浮动。
</ul>

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QDockWindow"></a>QDockWindow::QDockWindow ( <a href="qdockwindow.html#Place-enum">Place</a>&nbsp;p = InDock, <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;f = 0 )
</h3>
构造一个父对象为<em>parent</em>、名称为<em>name</em>并且窗口部件标记为<em>f</em>的QDockWindow。
<p> 如果<em>p</em>为<a href="#Place-enum">InDock</a>，这个锚接窗口被锚接如一个锚接区域并且<em>parent</em><em>必须</em>为<a href="qdockarea.html">QDockArea</a>或<a href="qmainwindow.html">QMainWindow</a>。如果<em>parent</em>为QMainWindow，锚接窗口将被锚接到这个主窗口的<a href="qt.html#Dock-enum">Top</a>锚接区域。
<p> 如果<em>p</em>为<a href="#Place-enum">OutsideDock</a>，<em>parent</em><em>必须</em>为0并且这个锚接窗口被创建为浮动窗口。
<p> 我们建议创建QMainWindow为父对象，锚接位置为<a href="#Place-enum">InDock</a>的锚接窗口，然后调用<a href="qmainwindow.html#moveDockWindow">QMainWindow::moveDockWindow</a>()来把这个锚接窗口移动到你想要的位置。

<h3 class=fn><a href="qdockarea.html">QDockArea</a>&nbsp;* <a name="area"></a>QDockWindow::area () const
</h3> 
<p> 返回锚接窗口被锚接的锚接区域，或者如果它正在浮动，返回0。

<h3 class=fn><a href="qboxlayout.html">QBoxLayout</a>&nbsp;* <a name="boxLayout"></a>QDockWindow::boxLayout ()
</h3> 
返回用于把窗口部件添加到锚接窗口的布局。布局的方向自动与锚接窗口的方向匹配。你可以使用盒子布局的<a href="qboxlayout.html#addWidget">QBoxLayout::addWidget</a>()函数来添加窗口部件到这个布局中。
<p> 如果锚接窗口只需要包含一个窗口部件，请使用<a href="#setWidget">setWidget</a>()来替代它。
<p> <p>也可以参考<a href="#setWidget">setWidget</a>()和<a href="#setOrientation">setOrientation</a>()。

<h3 class=fn>int <a name="closeMode"></a>QDockWindow::closeMode () const
</h3>
<p>返回锚接窗口的关闭模式。详细情况请参考<a href="qdockwindow.html#closeMode-prop">“closeMode”</a>属性。

<h3 class=fn>void <a name="dock"></a>QDockWindow::dock ()<tt> [虚 槽]</tt>
</h3> 
把锚接窗口锚接到它最近一次被锚接的锚接区域中。
<p> 如果锚接窗口没有最近一次被锚接的区域（例如它被创建为浮动的并且从没有被锚接过），或者如果最近一次被锚接的区域已经不存在了（例如那个锚接区域已经被删除了），就什么也不会发生。
<p> <p>也可以参考<a href="#undock">undock</a>()。

<h3 class=fn><a href="qsize.html">QSize</a> <a name="fixedExtent"></a>QDockWindow::fixedExtent () const
</h3> 
返回锚接窗口的首选大小（固定的宽度）。
<p> <p>也可以参考<a href="#setFixedExtentWidth">setFixedExtentWidth</a>()和<a href="#setFixedExtentHeight">setFixedExtentHeight</a>()。

<h3 class=fn>bool <a name="isCloseEnabled"></a>QDockWindow::isCloseEnabled () const
</h3> 
如果锚接窗口有一个关闭按钮，返回真，否则返回假。这个结果依赖于锚接窗口的<a href="#Place-enum">Place</a>和它的<a href="#CloseMode-enum">CloseMode</a>。
<p> <p>也可以参考<a href="#closeMode-prop">closeMode</a>。

<h3 class=fn>bool <a name="isHorizontalStretchable"></a>QDockWindow::isHorizontalStretchable () const
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

<h3 class=fn>bool <a name="isHorizontallyStretchable"></a>QDockWindow::isHorizontallyStretchable () const
</h3>
<p>如果锚接窗口是水平方向上可延伸的，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#horizontallyStretchable-prop">“horizontallyStretchable”</a>属性。

<h3 class=fn>bool <a name="isMovingEnabled"></a>QDockWindow::isMovingEnabled () const
</h3>
<p>如果用户可以在锚接区域内移动锚接窗口、把锚接窗口移动到其他锚接区域、或者浮动锚接窗口，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#movingEnabled-prop">“movingEnabled”</a>属性。

<h3 class=fn>bool <a name="isResizeEnabled"></a>QDockWindow::isResizeEnabled () const
</h3>
<p>如果锚接窗口是可以重新定义大小的，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#resizeEnabled-prop">“resizeEnabled”</a>属性。

<h3 class=fn>bool <a name="isStretchable"></a>QDockWindow::isStretchable () const
</h3>
<p>如果锚接窗口在当前的orientation()上是可延伸的，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#stretchable-prop">“stretchable”</a>属性。

<h3 class=fn>bool <a name="isVerticalStretchable"></a>QDockWindow::isVerticalStretchable () const
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

<h3 class=fn>bool <a name="isVerticallyStretchable"></a>QDockWindow::isVerticallyStretchable () const
</h3>
<p>如果锚接窗口是垂直方向上可延伸的，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#verticallyStretchable-prop">“verticallyStretchable”</a>属性。

<h3 class=fn>bool <a name="newLine"></a>QDockWindow::newLine () const
</h3>
<p>如果锚接窗口更愿意在锚接区域中新开一行，返回真否则返回假。详细情况请参考<a href="qdockwindow.html#newLine-prop">“newLine”</a>属性。

<h3 class=fn>int <a name="offset"></a>QDockWindow::offset () const
</h3>
<p>返回锚接窗口对于锚接区域的左边界（对于垂直锚接区域是上边界）首选的位移。详细情况请参考<a href="qdockwindow.html#offset-prop">“offset”</a>属性。

<h3 class=fn>bool <a name="opaqueMoving"></a>QDockWindow::opaqueMoving () const
</h3>
<p>如果在锚接窗口正在被移动的时候，锚接窗口将被正常显示，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#opaqueMoving-prop">“opaqueMoving”</a>属性。

<h3 class=fn><a href="qt.html#Orientation-enum">Qt::Orientation</a> <a name="orientation"></a>QDockWindow::orientation () const
</h3> 
返回锚接窗口的方向。
<p> <p>也可以参考<a href="#orientationChanged">orientationChanged</a>()。

<h3 class=fn>void <a name="orientationChanged"></a>QDockWindow::orientationChanged ( <a href="qt.html#Orientation-enum">Orientation</a>&nbsp;o )<tt> [信号]</tt>
</h3> 
<p> 当锚接窗口的方向发生改变时，这个信号被发射。新方向为<em>o</em>。

<h3 class=fn><a href="qdockwindow.html#Place-enum">Place</a> <a name="place"></a>QDockWindow::place () const
</h3>
<p>如果锚接窗口在锚接区域中，返回真，否则返回假。详细情况请参考<a href="qdockwindow.html#place-prop">“place”</a>属性。

<h3 class=fn>void <a name="placeChanged"></a>QDockWindow::placeChanged ( <a href="qdockwindow.html#Place-enum">QDockWindow::Place</a>&nbsp;p )<tt> [信号]</tt>
</h3> 
<p> 当锚接窗口被锚接时（<em>p</em>为<a href="#Place-enum">InDock</a>）或者被取消锚接时（<em>p</em>为<a href="#Place-enum">OutsideDock</a>），这个信号被发射。
<p> <p>也可以参考<a href="qdockarea.html#moveDockWindow">QDockArea::moveDockWindow</a>()、<a href="qdockarea.html#removeDockWindow">QDockArea::removeDockWindow</a>()、<a href="qmainwindow.html#moveDockWindow">QMainWindow::moveDockWindow</a>()和<a href="qmainwindow.html#removeDockWindow">QMainWindow::removeDockWindow</a>()。

<h3 class=fn>void <a name="setCloseMode"></a>QDockWindow::setCloseMode ( int&nbsp;m )<tt> [信号]</tt>
</h3>
<p>设置锚接窗口的关闭模式为<em>m</em>。详细情况请参考<a href="qdockwindow.html#closeMode-prop">“closeMode”</a>属性。

<h3 class=fn>void <a name="setFixedExtentHeight"></a>QDockWindow::setFixedExtentHeight ( int&nbsp;h )<tt> [虚]</tt>
</h3>
设置锚接窗口的固定宽度（大小）时的首选高度为<em>h</em>。
<p> <p>也可以参考<a href="#setFixedExtentWidth">setFixedExtentWidth</a>()。

<h3 class=fn>void <a name="setFixedExtentWidth"></a>QDockWindow::setFixedExtentWidth ( int&nbsp;w )<tt> [虚]</tt>
</h3> 
设置锚接窗口的固定宽度（大小）时的首选宽度为<em>w</em>。
<p> <p>也可以参考<a href="#setFixedExtentHeight">setFixedExtentHeight</a>()。

<h3 class=fn>void <a name="setHorizontalStretchable"></a>QDockWindow::setHorizontalStretchable ( bool&nbsp;b )
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

<h3 class=fn>void <a name="setHorizontallyStretchable"></a>QDockWindow::setHorizontallyStretchable ( bool&nbsp;b )<tt> [虚]</tt>
</h3>