正文

第十五篇 -- QListWidget与QToolButton（界面）

IP云
IP云V管理员/12 阅读
08/07
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

效果图：

这还只是一个界面，并没有实现相应功能。

先看下这图的构成吧。

工具栏的就是将Action拖上去，这部分前面已经介绍过了，那就看下面这部分的构图。

1.左侧是一个工具箱（ToolBox）组件，可以右键insert page或者delete page实现分组的添加或删除。在属性编辑器可以设置常用属性的值。

  • currentIndex：当前分组的编号，第一个分组的编号是0，通过改变这个值，可以选择不同的分组页面。
  • currentItemText：当前分组的标题。
  • currentItemName：当前分组的对象名称
  • currentItemIcon：为当前分组设置一个图标，显示在文字标题的左侧。

在第一个分组里防止几个QToolButton按钮，并设置为网格布局。注意不要使用水平布局，因为水平布局时组内的ToolButton按钮都是自动左对齐，而使用网格布局则是自动居中。如果碰到按钮大小的问题的话，可以设置按钮属性minimumsize中的Width和Height值。

2. 右侧是一个多页（QTabWidget）组件。

QTabWidget是一个多页的容器类组件。在窗体上放置一个QTabWidget组件，通过右键insert page或delete page等菜单项实现页面的添加或删除。在属性编辑器里可以设置一些常用属性的值。

tabPosition：页标签的位置，东南西北四个方位中选择一个

currentIndex：当前页的编号

currentTabText：当前页的标题
currentTabName：当前页的对象名称

currentTabIcon：可以为当前页设置一个图标，显示在文字标题的左侧

tabsCloseable：页面是否可以被关闭。若设置为True，则每个页面的标题栏上会出现一个关闭按钮，点击关闭按钮可以关闭页面。

3. 使用QSplitter设计分割界面

具有分割效果的典型界面就是Windows的资源管理器，QSplitter用于设计具有分割效果的界面，可以左右或上下分割。本示例主窗体工作区的两个主要组件是toolBox和tabWidget，希望这两个组件设计为左右分割的效果。同时选中这两个组件，右击选择Lay out->Lay Out Horizontally in Splitter，就可以为这两个组件创建一个水平分割的布局组件splitter。

在QmyMainWindow的构造函数里使用下面一行语句就可以使splitter充满整个工作区:

self.setCentralWidget(self.ui.splitter)

4. QListWidget组件

在第一页中，第一行是一个label标签，一个Line Edit控件，还有一个Check Box。第二行是四个QToolButton按钮，第三行就是一个QlistWidget组件。

在窗体可视化设计时双击ListWidget组件，可以打开其列表项编辑器，在这个编辑器里可以增加、删除、上移、下移列表项，可以设置每个项的属性，包括文字内容、字体、文字对齐方式、背景色、前景色等。

比较重要的是其flags属性（如图3-18所示），用于设置项的一些标志，以下这些标志是枚举类型Qt.ItemFlag的值的组合。

  • Selectable：项可被选择，对应枚举值Qt.ItemIsSelectable。
  • Editable：项可被编辑，对应枚举值Qt.ItemIsEditable。
  • DragEnabled：项可以被拖动，对应枚举值Qt.ItemIsDragEnabled。
  • DropEnabled：项可以接收拖放的项，对应枚举值Qt.ItemIsDropEnabled。
  • UserCheckable：项可以被复选，若为True，项前面出现一个CheckBox，对应枚举值Qt.ItemIsUserCheckable。
  • Enable：项被使能，对应枚举值Qt.ItemIsEnabled。
  • Tristate：允许Check的第三种状态，若为False，则只有checked和unchecked两种状态，对应枚举值Qt.ItemIsAutoTristate。

QListWidget的列表项一般是在程序里动态创建。

5. Action和槽

ui_listwidget.py

# -*- coding: utf-8 -*-# Form implementation generated from reading ui file 'ui_listwidget.ui'
#
# Created by: PyQt5 UI code generator 5.13.0
#
# WARNING! All changes made in this file will be lost!from PyQt5 import QtCore, QtGui, QtWidgetsclass Ui_MainWindow(object):
def setupUi(self, MainWindow):
MainWindow.setObjectName("MainWindow")
MainWindow.resize(800, 483)
self.centralwidget = QtWidgets.QWidget(MainWindow)
self.centralwidget.setObjectName("centralwidget")
self.splitter = QtWidgets.QSplitter(self.centralwidget)
self.splitter.setGeometry(QtCore.QRect(10, 10, 781, 381))
self.splitter.setOrientation(QtCore.Qt.Horizontal)
self.splitter.setObjectName("splitter")
self.toolBox = QtWidgets.QToolBox(self.splitter)
self.toolBox.setMaximumSize(QtCore.QSize(16777215, 16777215))
self.toolBox.setObjectName("toolBox")
self.page = QtWidgets.QWidget()
self.page.setGeometry(QtCore.QRect(0, 0, 152, 291))
self.page.setObjectName("page")
self.gridLayout = QtWidgets.QGridLayout(self.page)
self.gridLayout.setObjectName("gridLayout")
self.btnList_Ini = QtWidgets.QToolButton(self.page)
self.btnList_Ini.setMinimumSize(QtCore.QSize(130, 30))
self.btnList_Ini.setObjectName("btnList_Ini")
self.gridLayout.addWidget(self.btnList_Ini, 0, 0, 1, 1)
self.btnList_Clear = QtWidgets.QToolButton(self.page)
self.btnList_Clear.setMinimumSize(QtCore.QSize(130, 30))
self.btnList_Clear.setObjectName("btnList_Clear")
self.gridLayout.addWidget(self.btnList_Clear, 1, 0, 1, 1)
self.btnList_Insert = QtWidgets.QToolButton(self.page)
self.btnList_Insert.setMinimumSize(QtCore.QSize(130, 30))
self.btnList_Insert.setObjectName("btnList_Insert")
self.gridLayout.addWidget(self.btnList_Insert, 2, 0, 1, 1)
self.btnList_Append = QtWidgets.QToolButton(self.page)
self.btnList_Append.setMinimumSize(QtCore.QSize(130, 30))
self.btnList_Append.setObjectName("btnList_Append")
self.gridLayout.addWidget(self.btnList_Append, 3, 0, 1, 1)
self.btnList_Delete = QtWidgets.QToolButton(self.page)
self.btnList_Delete.setMinimumSize(QtCore.QSize(130, 30))
self.btnList_Delete.setObjectName("btnList_Delete")
self.gridLayout.addWidget(self.btnList_Delete, 4, 0, 1, 1)
icon = QtGui.QIcon()
icon.addPixmap(QtGui.QPixmap("Image/icons/list.ico"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.toolBox.addItem(self.page, icon, "")
self.page_2 = QtWidgets.QWidget()
self.page_2.setGeometry(QtCore.QRect(0, 0, 152, 291))
self.page_2.setObjectName("page_2")
icon1 = QtGui.QIcon()
icon1.addPixmap(QtGui.QPixmap("Image/icons/tree.ico"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.toolBox.addItem(self.page_2, icon1, "")
self.page_3 = QtWidgets.QWidget()
self.page_3.setObjectName("page_3")
icon2 = QtGui.QIcon()
icon2.addPixmap(QtGui.QPixmap("Image/icons/tabel.ico"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.toolBox.addItem(self.page_3, icon2, "")
self.tabWidget = QtWidgets.QTabWidget(self.splitter)
self.tabWidget.setObjectName("tabWidget")
self.tab = QtWidgets.QWidget()
self.tab.setObjectName("tab")
self.gridLayout_2 = QtWidgets.QGridLayout(self.tab)
self.gridLayout_2.setObjectName("gridLayout_2")
self.btnSel_None = QtWidgets.QToolButton(self.tab)
self.btnSel_None.setObjectName("btnSel_None")
self.gridLayout_2.addWidget(self.btnSel_None, 1, 3, 1, 1)
self.checkBox = QtWidgets.QCheckBox(self.tab)
font = QtGui.QFont()
font.setPointSize(10)
self.checkBox.setFont(font)
self.checkBox.setObjectName("checkBox")
self.gridLayout_2.addWidget(self.checkBox, 0, 6, 1, 1)
self.listWidget = QtWidgets.QListWidget(self.tab)
self.listWidget.setObjectName("listWidget")
item = QtWidgets.QListWidgetItem()
item.setFlags(QtCore.Qt.ItemIsSelectable|QtCore.Qt.ItemIsEditable|QtCore.Qt.ItemIsDragEnabled|QtCore.Qt.ItemIsUserCheckable|QtCore.Qt.ItemIsEnabled)
self.listWidget.addItem(item)
item = QtWidgets.QListWidgetItem()
item.setFlags(QtCore.Qt.ItemIsSelectable|QtCore.Qt.ItemIsEditable|QtCore.Qt.ItemIsDragEnabled|QtCore.Qt.ItemIsUserCheckable|QtCore.Qt.ItemIsEnabled)
self.listWidget.addItem(item)
self.gridLayout_2.addWidget(self.listWidget, 2, 0, 1, 7)
self.label = QtWidgets.QLabel(self.tab)
font = QtGui.QFont()
font.setPointSize(10)
self.label.setFont(font)
self.label.setObjectName("label")
self.gridLayout_2.addWidget(self.label, 0, 0, 1, 1)
self.lineEdit = QtWidgets.QLineEdit(self.tab)
self.lineEdit.setObjectName("lineEdit")
self.gridLayout_2.addWidget(self.lineEdit, 0, 1, 1, 5)
self.btnSel_ALL = QtWidgets.QToolButton(self.tab)
self.btnSel_ALL.setObjectName("btnSel_ALL")
self.gridLayout_2.addWidget(self.btnSel_ALL, 1, 2, 1, 1)
self.btnSel_Invs = QtWidgets.QToolButton(self.tab)
self.btnSel_Invs.setObjectName("btnSel_Invs")
self.gridLayout_2.addWidget(self.btnSel_Invs, 1, 4, 1, 1)
self.btnSelectItem = QtWidgets.QToolButton(self.tab)
self.btnSelectItem.setObjectName("btnSelectItem")
self.gridLayout_2.addWidget(self.btnSelectItem, 1, 0, 1, 2)
self.tabWidget.addTab(self.tab, "")
self.tab_2 = QtWidgets.QWidget()
self.tab_2.setObjectName("tab_2")
self.tabWidget.addTab(self.tab_2, "")
self.tab_3 = QtWidgets.QWidget()
self.tab_3.setObjectName("tab_3")
self.tabWidget.addTab(self.tab_3, "")
MainWindow.setCentralWidget(self.centralwidget)
self.menubar = QtWidgets.QMenuBar(MainWindow)
self.menubar.setGeometry(QtCore.QRect(0, 0, 800, 21))
self.menubar.setObjectName("menubar")
MainWindow.setMenuBar(self.menubar)
self.statusbar = QtWidgets.QStatusBar(MainWindow)
self.statusbar.setObjectName("statusbar")
MainWindow.setStatusBar(self.statusbar)
self.toolBar = QtWidgets.QToolBar(MainWindow)
self.toolBar.setToolButtonStyle(QtCore.Qt.ToolButtonTextUnderIcon)
self.toolBar.setObjectName("toolBar")
MainWindow.addToolBar(QtCore.Qt.TopToolBarArea, self.toolBar)
self.actList_Ini = QtWidgets.QAction(MainWindow)
icon3 = QtGui.QIcon()
icon3.addPixmap(QtGui.QPixmap("Image/icons/initial.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actList_Ini.setIcon(icon3)
self.actList_Ini.setObjectName("actList_Ini")
self.actList_Clear = QtWidgets.QAction(MainWindow)
icon4 = QtGui.QIcon()
icon4.addPixmap(QtGui.QPixmap("Image/icons/clear.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actList_Clear.setIcon(icon4)
self.actList_Clear.setObjectName("actList_Clear")
self.actList_Insert = QtWidgets.QAction(MainWindow)
icon5 = QtGui.QIcon()
icon5.addPixmap(QtGui.QPixmap("Image/icons/insert.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actList_Insert.setIcon(icon5)
self.actList_Insert.setObjectName("actList_Insert")
self.actList_Append = QtWidgets.QAction(MainWindow)
icon6 = QtGui.QIcon()
icon6.addPixmap(QtGui.QPixmap("Image/icons/append.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actList_Append.setIcon(icon6)
self.actList_Append.setObjectName("actList_Append")
self.actList_Delete = QtWidgets.QAction(MainWindow)
icon7 = QtGui.QIcon()
icon7.addPixmap(QtGui.QPixmap("Image/icons/delete.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actList_Delete.setIcon(icon7)
self.actList_Delete.setObjectName("actList_Delete")
self.actSel_ALL = QtWidgets.QAction(MainWindow)
self.actSel_ALL.setObjectName("actSel_ALL")
self.actSel_None = QtWidgets.QAction(MainWindow)
self.actSel_None.setObjectName("actSel_None")
self.actSel_Invs = QtWidgets.QAction(MainWindow)
self.actSel_Invs.setObjectName("actSel_Invs")
self.actQuit = QtWidgets.QAction(MainWindow)
icon8 = QtGui.QIcon()
icon8.addPixmap(QtGui.QPixmap("Image/icons/quit.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actQuit.setIcon(icon8)
self.actQuit.setObjectName("actQuit")
self.actSelPopMenu = QtWidgets.QAction(MainWindow)
icon9 = QtGui.QIcon()
icon9.addPixmap(QtGui.QPixmap("Image/icons/popmenu.jpg"), QtGui.QIcon.Normal, QtGui.QIcon.Off)
self.actSelPopMenu.setIcon(icon9)
self.actSelPopMenu.setObjectName("actSelPopMenu")
self.toolBar.addAction(self.actList_Ini)
self.toolBar.addAction(self.actList_Clear)
self.toolBar.addAction(self.actList_Insert)
self.toolBar.addAction(self.actList_Append)
self.toolBar.addAction(self.actList_Delete) self.retranslateUi(MainWindow)
self.toolBox.setCurrentIndex(0)
self.tabWidget.setCurrentIndex(0)
self.actSelPopMenu.triggered.connect(self.actSel_Invs.trigger)
self.actQuit.triggered.connect(MainWindow.close)
QtCore.QMetaObject.connectSlotsByName(MainWindow) def retranslateUi(self, MainWindow):
_translate = QtCore.QCoreApplication.translate
MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow"))
self.btnList_Ini.setText(_translate("MainWindow", "btnList_Ini"))
self.btnList_Clear.setText(_translate("MainWindow", "btnList_Clear"))
self.btnList_Insert.setText(_translate("MainWindow", "btnList_Insert"))
self.btnList_Append.setText(_translate("MainWindow", "btnList_Append"))
self.btnList_Delete.setText(_translate("MainWindow", "btnList_Delete"))
self.toolBox.setItemText(self.toolBox.indexOf(self.page), _translate("MainWindow", "QListWidget操作"))
self.toolBox.setItemText(self.toolBox.indexOf(self.page_2), _translate("MainWindow", "QTreeWidget"))
self.toolBox.setItemText(self.toolBox.indexOf(self.page_3), _translate("MainWindow", "QTabelWidget"))
self.btnSel_None.setText(_translate("MainWindow", "btnSel_None"))
self.checkBox.setText(_translate("MainWindow", "可编辑"))
__sortingEnabled = self.listWidget.isSortingEnabled()
self.listWidget.setSortingEnabled(False)
item = self.listWidget.item(0)
item.setText(_translate("MainWindow", "New Item"))
item = self.listWidget.item(1)
item.setText(_translate("MainWindow", "New Item1"))
self.listWidget.setSortingEnabled(__sortingEnabled)
self.label.setText(_translate("MainWindow", "当前项变化"))
self.btnSel_ALL.setText(_translate("MainWindow", "btnSel_ALL"))
self.btnSel_Invs.setText(_translate("MainWindow", "btnSel_Invs"))
self.btnSelectItem.setText(_translate("MainWindow", "btnSelectItem"))
self.tabWidget.setTabText(self.tabWidget.indexOf(self.tab), _translate("MainWindow", "QListWidget"))
self.tabWidget.setTabText(self.tabWidget.indexOf(self.tab_2), _translate("MainWindow", "QTreeWidget"))
self.tabWidget.setTabText(self.tabWidget.indexOf(self.tab_3), _translate("MainWindow", "QTableWidget"))
self.toolBar.setWindowTitle(_translate("MainWindow", "toolBar"))
self.actList_Ini.setText(_translate("MainWindow", "初始化列表"))
self.actList_Ini.setToolTip(_translate("MainWindow", "初始化列表"))
self.actList_Ini.setShortcut(_translate("MainWindow", "Ctrl+I"))
self.actList_Clear.setText(_translate("MainWindow", "清除列表"))
self.actList_Clear.setToolTip(_translate("MainWindow", "清除列表"))
self.actList_Insert.setText(_translate("MainWindow", "插入项"))
self.actList_Insert.setToolTip(_translate("MainWindow", "插入项"))
self.actList_Insert.setShortcut(_translate("MainWindow", "Ctrl+S"))
self.actList_Append.setText(_translate("MainWindow", "添加项"))
self.actList_Append.setToolTip(_translate("MainWindow", "添加项"))
self.actList_Append.setShortcut(_translate("MainWindow", "Ctrl+A"))
self.actList_Delete.setText(_translate("MainWindow", "删除当前项"))
self.actList_Delete.setToolTip(_translate("MainWindow", "删除当前项"))
self.actList_Delete.setShortcut(_translate("MainWindow", "Del"))
self.actSel_ALL.setText(_translate("MainWindow", "全选"))
self.actSel_ALL.setToolTip(_translate("MainWindow", "全选"))
self.actSel_None.setText(_translate("MainWindow", "全不选"))
self.actSel_None.setToolTip(_translate("MainWindow", "全不选"))
self.actSel_Invs.setText(_translate("MainWindow", "反选"))
self.actSel_Invs.setToolTip(_translate("MainWindow", "反选"))
self.actQuit.setText(_translate("MainWindow", "退出"))
self.actQuit.setToolTip(_translate("MainWindow", "退出程序"))
self.actSelPopMenu.setText(_translate("MainWindow", "项选择"))
self.actSelPopMenu.setToolTip(_translate("MainWindow", "项选择"))

myMainWindow_listwidget.py

#!/usr/bin/env python
# _*_ coding: UTF-8 _*_
"""=================================================
@Project -> File : Operate-system -> myMainWindow_listwidget.py
@IDE : PyCharm
@Author : zihan
@Date : 2020/4/14 9:24
@Desc :
================================================="""import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QListWidgetItem, QMenu, QToolButton
from PyQt5.QtGui import QIcon, QCursor
from PyQt5.QtCore import pyqtSlot, Qt
from ui_listwidget import Ui_MainWindowclass QmyMainWindow(QMainWindow):
def __init__(self, parent=None):
super().__init__(parent)
self.ui = Ui_MainWindow()
self.ui.setupUi(self) self.setCentralWidget(self.ui.splitter) # 使splitter充满整个工作区
self.__set_actions_for_button() # ToolButton关联Action
self.__create_selection_pop_menu() # ToolButton关联Action
def __set_actions_for_button(self):
self.ui.btnList_Ini.setDefaultAction(self.ui.actList_Ini)
self.ui.btnList_Clear.setDefaultAction(self.ui.actList_Clear) self.ui.btnList_Insert.setDefaultAction(self.ui.actList_Insert)
self.ui.btnList_Append.setDefaultAction(self.ui.actList_Append)
self.ui.btnList_Delete.setDefaultAction(self.ui.actList_Delete) self.ui.btnSel_ALL.setDefaultAction(self.ui.actSel_ALL)
self.ui.btnSel_None.setDefaultAction(self.ui.actSel_None)
self.ui.btnSel_Invs.setDefaultAction(self.ui.actSel_Invs) self.ui.btnList_Ini.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
self.ui.btnList_Clear.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
self.ui.btnList_Insert.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
self.ui.btnList_Append.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
self.ui.btnList_Delete.setToolButtonStyle(Qt.ToolButtonTextBesideIcon) # 创建ToolButton按钮的下拉菜单
def __create_selection_pop_menu(self):
menuSelection = QMenu(self) # 下拉菜单
menuSelection.addAction(self.ui.actSel_ALL)
menuSelection.addAction(self.ui.actSel_None)
menuSelection.addAction(self.ui.actSel_Invs) # listWidget上方的btnSelectItem按钮
self.ui.btnSelectItem.setPopupMode(QToolButton.MenuButtonPopup)
self.ui.btnSelectItem.setToolButtonStyle(Qt.ToolButtonTextBesideIcon)
self.ui.btnSelectItem.setDefaultAction(self.ui.actSelPopMenu)
self.ui.btnSelectItem.setMenu(menuSelection) # 设置下拉菜单 # 工具栏上的下拉式菜单按钮
toolBtn = QToolButton(self)
toolBtn.setPopupMode(QToolButton.InstantPopup)
toolBtn.setDefaultAction(self.ui.actSelPopMenu)
toolBtn.setToolButtonStyle(Qt.ToolButtonTextUnderIcon)
toolBtn.setMenu(menuSelection) # 设置下拉菜单
self.ui.toolBar.addWidget(toolBtn) # 工具栏添加分隔条和"退出"按钮
self.ui.toolBar.addSeparator()
self.ui.toolBar.addAction(self.ui.actQuit)if __name__ == "__main__":
app = QApplication(sys.argv) # 创建app，用QApplication类
form = QmyMainWindow()
form.show()
sys.exit(app.exec_())

ok.