停靠窗口

代码：

 1 #coding: utf-8
 2 from PyQt4.QtCore import *
 3 from PyQt4.QtGui import *
 4 import sys
 5 
 6 QTextCodec.setCodecForTr(QTextCodec.codecForName("utf8"))
 7 
 8 class MainWidget(QMainWindow):
 9     def __init__(self, parent=None):
10         super(MainWidget, self).__init__(parent)
11         self.setWindowTitle(self.tr("依靠窗口"))
12         #定义一个 QTextEdit 对象作为主窗口，并把此编辑框设为 MainWindow 的中央窗体。
13         te = QTextEdit(self.tr("主窗口"))
14         te.setAlignment(Qt.AlignCenter)
15         self.setCentralWidget(te)
16 
17         #停靠窗口1
18         dock1 = QDockWidget(self.tr("停靠窗口1"), self)
19         dock1.setFeatures(QDockWidget.DockWidgetMovable)
20         dock1.setAllowedAreas(Qt.LeftDockWidgetArea|Qt.RightDockWidgetArea)
21         te1 = QTextEdit(self.tr("窗口 1,可在 Main Window 的左部和右部停靠，不可浮动，不可关闭"))
22         dock1.setWidget(te1)
23         self.addDockWidget(Qt.RightDockWidgetArea, dock1)
24 
25         #停靠窗口2
26         dock2 = QDockWidget(self.tr("停靠窗口2"), self)
27         dock2.setFeatures(QDockWidget.DockWidgetFloatable|QDockWidget.DockWidgetClosable)
28         te2 = QTextEdit(self.tr("窗口2，只可浮动"))
29         dock2.setWidget(te2)
30         self.addDockWidget(Qt.RightDockWidgetArea, dock2)
31 
32         #停靠窗口3
33         dock3 = QDockWidget(self.tr("停靠窗口3"), self)
34         dock3.setFeatures(QDockWidget.DockWidgetFloatable|QDockWidget.DockWidgetClosable)
35         te3 = QTextEdit(self.tr("窗口3，可在Main Window任意位置停靠，可浮动，可关闭"))
36         dock3.setWidget(te3)
37         self.addDockWidget(Qt.RightDockWidgetArea, dock3)
38 
39 app = QApplication(sys.argv)
40 main = MainWidget()
41 main.show()
42 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：不可移动，不可关闭，不可浮动。
　　此参数也可采用或(|)的方式对停靠窗进行特性的设定