停靠窗口

代码:

 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:不可移动,不可关闭,不可浮动。
  此参数也可采用或(|)的方式对停靠窗进行特性的设定

 

posted @ 2015-05-30 14:52  Chris*Chen  阅读(718)  评论(0编辑  收藏  举报