qmainwindow.html

QT参考文档

</ul><p> 

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QMainWindow"></a>QMainWindow::QMainWindow ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;f = WType_TopLevel )
</h3>  
构造一个空的主窗口。<em>parent</em>、<em>name</em>和窗口部件标记<em>f</em>被传递给<a href="qwidget.html">QWidget</a>构造函数。
<p> 默认情况下，窗口部件标记被设置为WType_TopLevel而不是只把它作为QWidget的0。如果你不想让你的QMainWindow为一个顶级窗口部件，你将需要把<em>f</em>设置为0。

<h3 class=fn><a name="~QMainWindow"></a>QMainWindow::~QMainWindow ()
</h3> 
销毁这个对象并且释放所有已经分配的资源。

<h3 class=fn>void <a name="addDockWindow"></a>QMainWindow::addDockWindow ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dockWindow, <a href="qt.html#Dock-enum">Dock</a>&nbsp;edge = DockTop, bool&nbsp;newLine = FALSE )<tt> [虚]</tt>
</h3>  
把<em>dockWindow</em>添加到<em>edge</em>锚接区域。
<p> 如果<em>newLine</em>为假（默认），那么<em>dockWindow</em>被添加到<em>edge</em>的末尾。对于垂直边缘，末尾在下面，对于水平边缘（包含<a href="qt.html#Dock-enum">Minimized</a>），末尾在右面。如果<em>newLine</em>为真，会为锚接窗口开始新的一行，并且<em>dockWindow</em>作为第一个（最左面或者最上面）锚接窗口。
<p> 如果<em>dockWindow</em>被另一个主窗口管理，它首先从那一个窗口中被移除。

<h3 class=fn>void <a name="addDockWindow-2"></a>QMainWindow::addDockWindow ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dockWindow, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label, <a href="qt.html#Dock-enum">Dock</a>&nbsp;edge = DockTop, bool&nbsp;newLine = FALSE )<tt> [虚]</tt>
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 把标签为<em>label</em>的<em>dockWindow</em>添加到<em>edge</em>锚接区域。
<p> 如果<em>newLine</em>为假（默认），那么<em>dockWindow</em>被添加到<em>edge</em>的末尾。对于垂直边缘，末尾在下面，对于水平边缘（包含<a href="qt.html#Dock-enum">Minimized</a>），末尾在右面。如果<em>newLine</em>为真，会为锚接窗口开始新的一行，并且<em>dockWindow</em>作为第一个（最左面或者最上面）锚接窗口。
<p> 如果<em>dockWindow</em>被另一个主窗口管理，它首先从那一个窗口中被移除。

<h3 class=fn>void <a name="addToolBar"></a>QMainWindow::addToolBar ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*, <a href="qt.html#Dock-enum">Dock</a> = DockTop, bool&nbsp;newLine = FALSE )
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

<h3 class=fn>void <a name="addToolBar-2"></a>QMainWindow::addToolBar ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;label, <a href="qt.html#Dock-enum">Dock</a> = DockTop, bool&nbsp;newLine = FALSE )
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn>bool <a name="appropriate"></a>QMainWindow::appropriate ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dw ) const
</h3>
如果适合在锚接窗口菜单中包含一个可以列出<em>dw</em>锚接窗口的菜单项，返回真，否则返回假。
<p> 用户可以通过点击菜单项来改变有菜单项的锚接窗口的状态（显示或者隐藏）。
<p> 调用<a href="#setAppropriate">setAppropriate</a>()来指出一个特定锚接窗口是否应该显示在弹出菜单中。
<p> <p>也可以参考<a href="#setAppropriate">setAppropriate</a>()。

<h3 class=fn><a href="qdockarea.html">QDockArea</a>&nbsp;* <a name="bottomDock"></a>QMainWindow::bottomDock () const
</h3> 
返回<a href="qt.html#Dock-enum">Bottom</a>锚接区域的指针。
<p> <p>也可以参考<a href="#topDock">topDock</a>()、<a href="#leftDock">leftDock</a>()和<a href="#rightDock">rightDock</a>()。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="centralWidget"></a>QMainWindow::centralWidget () const
</h3>  
返回主窗口的中央窗口部件的指针。
<p> 中央窗口部件就是被上、下、左、右锚接区域环绕的。菜单条在上锚接区域的上面。
<p> <p>也可以参考<a href="#setCentralWidget">setCentralWidget</a>()。
<p>实例：<a href="qfd-example.html#x1997">qfd/qfd.cpp</a>。

<h3 class=fn>void <a name="childEvent"></a>QMainWindow::childEvent ( <a href="qchildevent.html">QChildEvent</a>&nbsp;*&nbsp;e )<tt> [虚 保护]</tt>
</h3>
监视事件，从<em>e</em>中接收，来保证布局被更新。
<p>从<a href="qobject.html#childEvent">QObject</a>中重新实现。

<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a>&nbsp;* <a name="createDockWindowMenu"></a>QMainWindow::createDockWindowMenu ( <a href="qmainwindow.html#DockWindows-enum">DockWindows</a>&nbsp;dockWindows = AllDockWindows ) const
</h3>  
创建一个包含所有工具条（如果<em>dockWindows</em>为<a href="#DockWindows-enum">OnlyToolBars</a>）、所有锚接窗口（如果<em>dockWindows</em>为<a href="#DockWindows-enum">NoToolBars</a>）或者所有工具条和锚接窗口（如果<em>dockWindows</em>为<a href="#DockWindows-enum">AllDockWindows</a>——默认）的锚接窗口菜单。
<p> 当需要的时候，例如当用户右键点击一个锚接区域（假如<a href="#isDockMenuEnabled">isDockMenuEnabled</a>()返回真）时，这个函数被内部调用。如果你想自定义这个行为，你可以重新实现这个函数。
<p> 呈现工具条和锚接窗口的菜单项是可选择的。可视的锚接窗口被选择的并且隐藏的锚接窗口是被取消选择的。用户点击一个菜单项来改变它的状态（显示或者隐藏这个锚接窗口）。
<p> 这个列表和状态总是保持最新。
<p> 在当前上下文（请参考<a href="#setAppropriate">setAppropriate</a>()）中是不适合的工具条和锚接窗口不会在这个菜单中被列出来。
<p> 这个菜单也有一个把锚接窗口排成一行的菜单选项。
<p> 如果<a href="#isCustomizable">isCustomizable</a>()返回真，一个Customize的菜单项被添加到菜单中，如果它被点击，就会调用<a href="#customize">customize</a>()。我们提供的isCustomizable()函数返回假并且customize()什么也不做，所以它们必须在子类中被重新实现才能有用。

<h3 class=fn>void <a name="customize"></a>QMainWindow::customize ()<tt> [虚 槽]</tt>
</h3> 
当用户点击在锚接窗口菜单中的Customize菜单项时，这个函数被调用。
<p> 只有在<a href="#isCustomizable">isCustomizable</a>()返回真（默认为假）时，Customize菜单项才会出现。
<p> 这个函数是有意图的，例如，提供给用户来告诉应用程序他们要自定义主窗口、锚接窗口或者锚接区域的一个手段。
<p> 默认实现是什么也不做，但是这可能在以后的Qt版本中发生改变。现在默认情况下，Customize菜单项不会显示在右键菜单中。如果你想让这项出现，那么请重新实现isCustomizable()来返回真。
<p> <p>也可以参考<a href="#isCustomizable">isCustomizable</a>()。

<h3 class=fn>void <a name="dockWindowPositionChanged"></a>QMainWindow::dockWindowPositionChanged ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dockWindow )<tt> [信号]</tt>
</h3>
<p> 当<em>dockWindow</em>已经改变位置时，这个信号被发射。当锚接窗口被移入它的锚接区域或者移到另一个锚接区域（包括<a href="qt.html#Dock-enum">Minimized</a>和<tt>TearOff</tt>锚接区域）时，位置的变化发生。
<p> <p>也可以参考<a href="#getLocation">getLocation</a>()。

<h3 class=fn><a href="qptrlist.html">QPtrList</a>&lt;QDockWindow&gt; <a name="dockWindows"></a>QMainWindow::dockWindows ( <a href="qt.html#Dock-enum">Dock</a>&nbsp;dock ) const
</h3>  
返回在<em>dock</em>锚接区域的所有锚接窗口的列表，而不管它们的状态。
<p> 例如，<a href="qt.html#Dock-enum">TornOff</a>锚接区域可能包含关闭的锚接窗口，但它们会和可视锚接窗口一起被返回。

<h3 class=fn><a href="qptrlist.html">QPtrList</a>&lt;QDockWindow&gt; <a name="dockWindows-2"></a>QMainWindow::dockWindows () const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回属于主窗口的所有锚接窗口的列表，而不管它们的状态（也就是不考虑它们是否可视）。

<h3 class=fn>bool <a name="dockWindowsMovable"></a>QMainWindow::dockWindowsMovable () const
</h3>
<p>如果锚接窗口是可移动的，返回真，否则返回假。详细情况请参考<a href="qmainwindow.html#dockWindowsMovable-prop">“dockWindowsMovable”</a>属性。

<h3 class=fn>bool <a name="getLocation"></a>QMainWindow::getLocation ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dw, <a href="qt.html#Dock-enum">Dock</a>&nbsp;&amp;&nbsp;dock, int&nbsp;&amp;&nbsp;index, bool&nbsp;&amp;&nbsp;nl, int&nbsp;&amp;&nbsp;extraOffset ) const
</h3>
找到锚接窗口<em>dw</em>的定位。
<p> 如果锚接窗口<em>dw</em>在主窗口中被找到，函数返回真并且<em>dock</em>变量为<em>dw</em>所在的锚接区域并且<em>index</em>为<em>dw</em>在锚接区域中的位置索引。如果<em>dw</em>开始一个新行，它也设置<em>nl</em>为真（否则为假），并且<em>extraOffset</em>为<em>dw</em>的位移。
<p> 如果<em>dw</em>在主窗口中没有被找到，那么这个函数返回真并且<em>dock</em>、<em>index</em>、<em>nl</em>和<em>extraOffset</em>的状态都是不确定的。
<p> 如果你想保存并且恢复锚接窗口的位置，那么请使用<a href="#operator-gt-gt">operator&gt;&gt;</a>()和<a href="#operator-lt-lt">operator&lt;&lt;</a>()。
<p> <p>也可以参考<a href="#operator-gt-gt">operator&gt;&gt;</a>()和<a href="#operator-lt-lt">operator&lt;&lt;</a>()。

<h3 class=fn>bool <a name="hasDockWindow"></a>QMainWindow::hasDockWindow ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dw )
</h3> 
如果<em>dw</em>是被主窗口知道的锚接窗口，返回真，否则返回假。

<h3 class=fn>bool <a name="isCustomizable"></a>QMainWindow::isCustomizable () const<tt> [虚]</tt>
</h3>
如果锚接区域的锚接窗口菜单包含Customize菜单项（当它被点击时，会调用customize()），返回真。默认返回假，也就是弹出菜单不包含Customize菜单选项。如果你希望用户能在锚接窗口菜单中看到它时，你将需要重新实现这个函数并且把它设置为返回真。
<p> <p>也可以参考<a href="#customize">customize</a>()。

<h3 class=fn>bool <a name="isDockEnabled"></a>QMainWindow::isDockEnabled ( <a href="qt.html#Dock-enum">Dock</a>&nbsp;dock ) const
</h3>  
如果<em>dock</em>锚接区域是生效的，返回真，也就是它可以接收用户拖动的锚接窗口，否则返回假。
<p> <p>也可以参考<a href="#setDockEnabled">setDockEnabled</a>()。

<h3 class=fn>bool <a name="isDockEnabled-2"></a>QMainWindow::isDockEnabled ( <a href="qdockarea.html">QDockArea</a>&nbsp;*&nbsp;area ) const
</h3>  
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果<em>area</em>是生效的，返回真，也就是它可以接收用户拖动的锚接窗口，否则返回假。
<p> <p>也可以参考<a href="#setDockEnabled">setDockEnabled</a>()。

<h3 class=fn>bool <a name="isDockEnabled-3"></a>QMainWindow::isDockEnabled ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;tb, <a href="qt.html#Dock-enum">Dock</a>&nbsp;dock ) const
</h3>  
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果<em>dock</em>对于锚接窗口<em>tb</em>是生效的，返回真，否则返回假。
<p> <p>也可以参考<a href="#setDockEnabled">setDockEnabled</a>()。

<h3 class=fn>bool <a name="isDockEnabled-4"></a>QMainWindow::isDockEnabled ( <a href="qdockwindow.html">QDockWindow</a>&nbsp;*&nbsp;dw, <a href="qdockarea.html">QDockArea</a>&nbsp;*&nbsp;area ) const
</h3>  
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。