PyQt5 QDockWidget控件应用详解_Python

前言

qdockwidget是一个可以停靠在qmainwindow内的窗口控件，它可以保持在浮动状态或者在指定位置作为子窗口附加到主窗口中，qmainwindow类的主窗口对象保留有一个用于停靠窗口的区域，这个区域在控件的中央周围

qdockwidget类中的常用方法

方法	描述
setwidget()	在dock窗口区域设置qwidget
setfloating()	设置dock窗口是否可以浮动，如果设置为true，则表示可以浮动
setalllowedareas()	设置窗口可以停靠的区域
	leftdockwidgetarea:左侧停靠区域
	rightdockwidgetarea:右侧停靠区域
	topdockwidgetarea:顶部停靠区域
	bottomdockwidgetarea:底部停靠区域
	nodockwidgetarea:不显示widget
setfearures()	设置停靠窗口的功能属性
	dockwidgetclosable:可关闭
	dockwidgetmovable：可移动
	dockwidgetfloatable：可漂浮
	dockwidgetverticaltitlebar：在左边显示垂直的标签栏
	alldockwidgetfeatures:具有前三种属性的所有功能
	nodockwidgetfeatures:无法关闭，不能悬浮，不能移动

实例：qdockwidget的使用

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_())

不重写qdockwidget类

import sys
from pyqt5.qtcore import *
from pyqt5.qtwidgets import qmainwindow, qtextedit, qdockwidget, qpushbutton, qapplication


class dockdemo(qmainwindow):
  def __init__(self):
    super().__init__()
    self.docker1=qdockwidget('docker1', self)
    self.docker2=qdockwidget('docker2', self)
    self.textedit=qtextedit()
    self.setcentralwidget(self.textedit)
    self.btn1=qpushbutton('btn1')
    self.btn2=qpushbutton('btn2')
    self.btn1.clicked.connect(self.btn1fun)
    self.btn2.clicked.connect(self.btn2fun)
    self.docker1.setwidget(self.btn1)
    self.docker2.setwidget(self.btn2)
    self.adddockwidget(qt.rightdockwidgetarea,self.docker1)
    self.adddockwidget(qt.leftdockwidgetarea, self.docker2)
    self.setwindowtitle('dock 例子')
    self.resize(400, 300)
  def btn1fun(self):
    self.textedit.settext('btn1')
    self.docker2.setfloating(true)#开启悬浮状态
  def btn2fun(self):
    self.textedit.settext('btn2')
    self.docker1.setfloating(true)
    
if __name__ == '__main__':
  app=qapplication(sys.argv)
  demo=dockdemo()
  demo.show()
  sys.exit(app.exec_())

效果:

重写qdockwidget类

import sys
from pyqt5.qtcore import *
from pyqt5.qtwidgets import qmainwindow, qtextedit, qdockwidget, qpushbutton, qapplication, qwidget, qvboxlayout


class docker(qdockwidget):
  def __init__(self, parent):
    super().__init__(parent)
    self.btn1 = qpushbutton('btn1')
    self.btn2 = qpushbutton('btn2')
    self.vbox = qvboxlayout()
    self.vbox.addwidget(self.btn1)
    self.vbox.addwidget(self.btn2)
    self.wgt = qwidget()
    self.wgt.setlayout(self.vbox)
    self.setwidget(self.wgt)

class dockdemo(qmainwindow):
  def __init__(self):
    super().__init__()
    self.docker = docker(self)
    self.textedit = qtextedit()
    self.setcentralwidget(self.textedit)
    self.docker.btn1.clicked.connect(self.btn1fun)
    self.docker.btn2.clicked.connect(self.btn2fun)
    self.adddockwidget(qt.rightdockwidgetarea, self.docker)
    self.setwindowtitle('dock 例子')
    self.resize(400, 300)

  def btn1fun(self):
    self.textedit.settext('btn1')

  def btn2fun(self):
    self.textedit.settext('btn2')


if __name__ == '__main__':
  app = qapplication(sys.argv)
  demo = dockdemo()
  demo.show()
  sys.exit(app.exec_())

效果: