PyQt5高级界面控件之QDockWidget(八)

左手的ㄟ右手 2023-05-31 07:43 4阅读 0赞

## 前言 ##

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

## QDoCKWidget类中的常用方法 ##

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>setWidget()</td> 
   <td>在Dock窗口区域设置QWidget</td> 
  </tr> 
  <tr> 
   <td>setFloating()</td> 
   <td>设置Dock窗口是否可以浮动，如果设置为True，则表示可以浮动</td> 
  </tr> 
  <tr> 
   <td>setAlllowedAreas()</td> 
   <td>设置窗口可以停靠的区域</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>LeftDockWidgetArea:左侧停靠区域</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>RightDockWidgetArea:右侧停靠区域</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>TopDockWidgetArea:顶部停靠区域</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>BottomDockWidgetArea:底部停靠区域</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>NoDockWidgetArea:不显示Widget</td> 
  </tr> 
  <tr> 
   <td>setFearures()</td> 
   <td>设置停靠窗口的功能属性</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>DockWidgetClosable:可关闭</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>DockWidgetMovable：可移动</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>DockWidgetFloatable：可漂浮</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>DockWidgetVerticalTitleBar：在左边显示垂直的标签栏</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>AllDockWidgetFeatures:具有前三种属性的所有功能</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>NoDockWidgetFeatures:无法关闭，不能悬浮，不能移动</td> 
  </tr> 
 </tbody> 
</table>

## 实例：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_())

运行程序，显示效果如下  
![这里写图片描述][70]![这里写图片描述][70 1]![这里写图片描述][70 2]  
可以拖动，停靠在上下左右四个地方，也可以悬浮于主窗口外

## 代码分析 ##

> 在这个例子中，顶层窗口是一个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)

*  QDockWidget
    
     *  前言
     *  QDoCKWidget类中的常用方法
     *  实例：QDockWidget的使用
     *  代码分析
        
         *   *  相关文件及下载地址

#### 相关文件及下载地址 ####

[https://download.csdn.net/download/jia666666/10609488][https_download.csdn.net_download_jia666666_10609488]

[70]: https://img-blog.csdn.net/20180814163811587?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYTY2NjY2Ng==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 1]: https://img-blog.csdn.net/20180814163820255?watermark/2/text/aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYTY2NjY2Ng==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70
[70 2]: /images/20230531/fee856ba848d433d864dfd83adb888f5.png
[https_download.csdn.net_download_jia666666_10609488]: https://download.csdn.net/download/jia666666/10609488