PyQt4 精彩实例分析* 实例15 停靠窗口

本实例实现停靠窗口的基本使用方法，实现的效果图如下所示。





本实例实现的停靠窗口的可实现状态已在各窗口中进行了描述，停靠窗口1只可在主窗口的左边和右边停靠，停靠窗口2只可在浮动和在右停靠两种状态间切换，并且不可移动，停靠窗口3可实现停靠窗口的各个状态。具体状态此处不再一一用图示的方式列出，读者可自行运行代码进行试验。

具体实现代码如下：

# -*- coding: utf-8 -*-
from PyQt4.QtGui import *
from PyQt4.QtCore 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("依靠窗口"))

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.AllDockWidgetFeatures)
te3=QTextEdit(self.tr("窗口3,可在Main Window任意位置停靠，可浮动，可关闭"))
dock3.setWidget(te3)
self.addDockWidget(Qt.BottomDockWidgetArea,dock3)

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

第11行设置主窗口的标题栏文字。

第13-15行定义一个QTextEdit对象作为主窗口，并把此编辑框设为MainWindow的中央窗体。

第18-23行设置停靠窗口1。

第26-30行设置停靠窗口2。

第33-37行设置停靠窗口3。

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

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：可停靠在插入处。

各区域设定可采用或(|)的方式进行设定，如本实例中的第8行。

setFeatures()方法设置停靠窗体的特性，原型如下：

setFeatures (self, DockWidgetFeatures)

参数QDockWidgetFeatures指定停靠窗体的特性，包括以下几种。

QDockWidget.DockWidgetClosable：停靠窗可关闭，右上角的关闭按钮。

QDockWidget.DockWidgetMovable：停靠窗可移动。

QDockWidget.DockWidgetFloatable：停靠窗可浮动。

QDockWidget.AllDockWidgetFeature：此参数表示拥有停靠窗的所有特性。

QDockWidget.NoDockWidgetFeature：不可移动，不可关闭，不可浮动。

此参数也可采用或(|)的方式对停靠窗进行特性的设定，如实例中的第27行所示。

 

 

注：本文基本上是经过改编的《Linux窗口程序设计--Qt4精彩实例分析》一书的PyQt4 for windows版本

转自：http://blog.csdn.net/chumpklutz/article/details/6074640