PyQt5 QDock小工具
一个可停靠的窗口是一个子窗口,它可以保持浮动状态,也可以在一个指定的位置附加到主窗口。QMainWindow类的主窗口对象有一个为可停靠窗口保留的区域。这个区域在中央部件的周围。
一个可停靠的窗口可以在主窗口内移动,或者它们可以被取消停靠,由用户移动到一个新的区域。These properties are controlled by the following QDockWidget class methods −
序号 | 方法和描述 |
---|---|
1 | setWidget() 设置停靠窗口区域内的任何QWidget。 |
2 | setFloating() 如果设置为true,停靠窗口可以浮动。 |
3 | setAllowedAreas() 设置窗口可以停靠的区域 | LeftDockWidgetArea RightDockWidgetArea TopDockWidgetArea BottomDockWidgetArea NoDockWidgetArea |
4 | setFeatures() 设置Dock窗口的功能。 | DockWidgetClosable DockWidgetMovable DockWidgetFloatable DockWidgetVerticalTitleBar NoDockWidgetFeatures |
例子
在下面的例子中,顶级窗口是一个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 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 = 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()
上述代码产生以下输出。点击Dock图标,取消ListWidget窗口的停靠。双击以再次停靠 –