QDockWidget是一个可以停靠在QMainWindow内的窗口控件,它可以保持在浮动状态或者在指定位置作为子窗口附加到主窗口中,QMainWindow类的主窗口对象保留有一个用于停靠窗口的区域,这个区域在控件的中央周围
方法 | 描述 |
---|---|
setWidget() | 在Dock窗口区域设置QWidget |
setFloating() | 设置Dock窗口是否可以浮动,如果设置为True,则表示可以浮动 |
setAlllowedAreas() | 设置窗口可以停靠的区域 |
LeftDockWidgetArea:左侧停靠区域 | |
RightDockWidgetArea:右侧停靠区域 | |
TopDockWidgetArea:顶部停靠区域 | |
BottomDockWidgetArea:底部停靠区域 | |
NoDockWidgetArea:不显示Widget | |
setFearures() | 设置停靠窗口的功能属性 |
DockWidgetClosable:可关闭 | |
DockWidgetMovable:可移动 | |
DockWidgetFloatable:可漂浮 | |
DockWidgetVerticalTitleBar:在左边显示垂直的标签栏 | |
AllDockWidgetFeatures:具有前三种属性的所有功能 | |
NoDockWidgetFeatures:无法关闭,不能悬浮,不能移动 |
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class DockDemo(QMainWindow):
def __init__(self,parent=None):
super(DockDemo, self).__init__(parent)
#设置水平布局
layout=QHBoxLayout()
#实例化菜单栏
bar=self.menuBar()
#创建主菜单file,在其中添加子菜单
file=bar.addMenu('File')
file.addAction('New')
file.addAction('Save')
file.addAction('quit')
#创建QDockWidget窗口(标题,自身窗口)
self.items=QDockWidget('Dockable',self)
#实例化列表窗口,添加几个条目
self.listWidget=QListWidget()
self.listWidget.addItem('Item1')
self.listWidget.addItem('Item2')
self.listWidget.addItem('Item3')
self.listWidget.addItem('Item4')
#在窗口区域设置QWidget,添加列表控件
self.items.setWidget(self.listWidget)
#设置dock窗口是否可以浮动,True,运行浮动在外面,自动与主界面脱离,False,默认浮动主窗口内,可以手动脱离
self.items.setFloating(False)
#设置QTextEdit为中央小控件
self.setCentralWidget(QTextEdit())
#将窗口放置在中央小控件的右侧
self.addDockWidget(Qt.RightDockWidgetArea,self.items)
self.setLayout(layout)
self.setWindowTitle('Dock 例子')
if __name__ == '__main__':
app=QApplication(sys.argv)
demo=DockDemo()
demo.show()
sys.exit(app.exec_())
运行程序,显示效果如下
在这个例子中,顶层窗口是一个QMainWindow对象,QTextEdit对象是它的中央小控件
self.setCentralWidget(QTextEdit())
首先创造可停靠的窗口Item
self.items=QDockWidget('Dockable',self)
然后,在停靠窗口内添加QListWidget对象
self.listWidget=QListWidget()
self.listWidget.addItem('Item1')
self.listWidget.addItem('Item2')
self.listWidget.addItem('Item3')
self.listWidget.addItem('Item4')
#在窗口区域设置QWidget,添加列表控件
self.items.setWidget(self.listWidget)
最后,停靠窗口放置在中央小控件的右侧
self.addDockWidget(Qt.RightDockWidgetArea,self.items)
联系客服