目录

QDock

可停靠窗口是一个子窗口,可以保持浮动状态,也可以在指定位置附加到主窗口。 QMainWindow类的主窗口对象具有为可停靠窗口保留的区域。 这个区域位于中央小部件周围。

可以在主窗口内移动停靠窗口,也可以将它们取消停靠以由用户移动到新区域中。 这些属性由以下QDockWidget类方法控制 -

Sr.No. 方法和描述
1

setWidget()

在停靠窗口的区域中设置任何QWidget

2

setFloating()

如果设置为true,则停靠窗口可以浮动

3

setAllowedAreas()

设置窗口可以停靠的区域

LeftDockWidgetArea
RightDockWidgetArea
TopDockWidgetArea
BottomDockWidgetArea
NoDockWidgetArea
4

setFeatures()

设置停靠窗口的功能

DockWidgetClosable
DockWidgetMovable
DockWidgetFloatable
DockWidgetVerticalTitleBar
NoDockWidgetFeatures

例子 (Example)

在以下示例中,顶级窗口是QMainWindow对象。 QTextEdit对象是其中心窗口小部件。

self.setCentralWidget(QTextEdit())

首先创建一个可停靠的窗口。

self.items = QDockWidget("Dockable", self)

将QListWidget对象添加为停靠窗口。

self.listWidget = QListWidget()
self.listWidget.addItem("item1")
self.listWidget.addItem("item2")
self.listWidget.addItem("item3")
self.items.setWidget(self.listWidget)

可停靠对象位于中央窗口小部件的右侧。

self.addDockWidget(Qt.RightDockWidgetArea,self.items)

完整的代码如下 -

import sys
from PyQt4.QtCore import *
from PyQt4.QtGui import *
class dockdemo(QMainWindow):
   def __init__(self, parent = None):
      super(dockdemo, self).__init__(parent)
      layout = QHBoxLayout()
      bar = self.menuBar()
      file = bar.addMenu("File")
      file.addAction("New")
      file.addAction("save")
      file.addAction("quit")
      self.items = QDockWidget("Dockable", self)
      self.listWidget = QListWidget()
      self.listWidget.addItem("item1")
      self.listWidget.addItem("item2")
      self.listWidget.addItem("item3")
      self.items.setWidget(self.listWidget)
      self.items.setFloating(False)
      self.setCentralWidget(QTextEdit())
      self.addDockWidget(Qt.RightDockWidgetArea, self.items)
      self.setLayout(layout)
      self.setWindowTitle("Dock demo")
def main():
   app = QApplication(sys.argv)
   ex = dockdemo()
   ex.show()
   sys.exit(app.exec_())
if __name__ == '__main__':
   main()

上面的代码产生以下输出 -

QDockWidget输出
↑回到顶部↑
WIKI教程 @2018