停靠窗口

代码：

#coding: utf-8
from PyQt4.QtCore import *
from PyQt4.QtGui import *
import sys

QTextCodec.setCodecForTr(QTextCodec.codecForName("utf8"))

class MainWidget(QMainWindow):
def __init__(self, parent=None):
super(MainWidget, self).__init__(parent)
self.setWindowTitle(self.tr("依靠窗口"))
#定义一个 QTextEdit 对象作为主窗口，并把此编辑框设为 MainWindow 的中央窗体。
te = QTextEdit(self.tr("主窗口"))
te.setAlignment(Qt.AlignCenter)
self.setCentralWidget(te)

#停靠窗口1
dock1 = QDockWidget(self.tr("停靠窗口1"), self)
dock1.setFeatures(QDockWidget.DockWidgetMovable)
dock1.setAllowedAreas(Qt.LeftDockWidgetArea|Qt.RightDockWidgetArea)
te1 = QTextEdit(self.tr("窗口 1,可在 Main Window 的左部和右部停靠，不可浮动，不可关闭"))
dock1.setWidget(te1)
self.addDockWidget(Qt.RightDockWidgetArea, dock1)

#停靠窗口2
dock2 = QDockWidget(self.tr("停靠窗口2"), self)
dock2.setFeatures(QDockWidget.DockWidgetFloatable|QDockWidget.DockWidgetClosable)
te2 = QTextEdit(self.tr("窗口2，只可浮动"))
dock2.setWidget(te2)
self.addDockWidget(Qt.RightDockWidgetArea, dock2)

#停靠窗口3
dock3 = QDockWidget(self.tr("停靠窗口3"), self)
dock3.setFeatures(QDockWidget.DockWidgetFloatable|QDockWidget.DockWidgetClosable)
te3 = QTextEdit(self.tr("窗口3，可在Main Window任意位置停靠，可浮动，可关闭"))
dock3.setWidget(te3)
self.addDockWidget(Qt.RightDockWidgetArea, dock3)

app = QApplication(sys.argv)
main = MainWidget()
main.show()
app.exec_()

设置停靠窗口的一般流程为：

　　1) 创建一个 QDockWidget 对象的停靠窗体。

　　2）设置此停靠窗体的属性，通常调用 setFeatures()及 setAllowedAreas()两个方法。

　　3）新建一个要插入停靠窗体的控件，本实例中为 QTextEdit，也可为其他控件，常用的一般为 QListWidget 和 QTextEdit。

　　4）把控件插入停靠窗体，调用 QDockWidget 的 setWidget()方法。

　　5）使用 addDockWidget()方法在 MainWindow 中加入此停靠窗体。

本实例的 3 个停靠窗体都是按此流程实现的，此处需要重点介绍的是设置停靠窗体状态的方法 setAllowedAreas()和 setFeatures()。

其中 setAllowedAreas()方法设置停靠窗体可停靠的区域，原型如下：

　　setAllowedAreas (self, Qt.DockWidgetAreas)
参数 Qt.DockWidgetAreas 指定了停靠窗体可停靠的区域，包括以下几种。
　　Qt.LeftDockWidgetArea：可在主窗口的左侧停靠。
　　Qt.RightDockWidgetArea：可在主窗口的右侧停靠。
　　Qt.TopDockWidgetArea：可在主窗口的顶端停靠。
　　Qt.BottomDockWidgetArea：可在主窗口的底部停靠。
　　Qt.AllDockWidgetArea：可在主窗口任意（以上四个）部位停靠。
　　Qt.NoDockWidgetArea：可停靠在插入处。
　　各区域设定可采用或(|)的方式进行设定

setFeatures()方法设置停靠窗体的特性，原型如下：
　　setFeatures (self, DockWidgetFeatures)
参数 QDockWidgetFeatures 指定停靠窗体的特性，包括以下几种。
　　QDockWidget.DockWidgetClosable：停靠窗可关闭，右上角的关闭按钮。
　　QDockWidget.DockWidgetMovable：停靠窗可移动。
　　QDockWidget.DockWidgetFloatable：停靠窗可浮动。
　　QDockWidget.AllDockWidgetFeature：此参数表示拥有停靠窗的所有特性。
　　QDockWidget.NoDockWidgetFeature：不可移动，不可关闭，不可浮动。
　　此参数也可采用或(|)的方式对停靠窗进行特性的设定