PyQt5 QCommandLinkButton – 切换可检查按钮

PyQt5是Python中常用的GUI开发工具包，其中QCommandLinkButton是PyQt5中常用的一个按钮控件之一。本文将详细讲解如何使用PyQt5编写QCommandLinkButton控件，以及如何实现切换可检查按钮的功能。

QCommandLinkButton简介

QCommandLinkButton是PyQt5中的一个按钮控件，它提供了一个类似于网页中超链接的感觉。常用场景包括体现“立即执行”“下载”“安装”等操作。

QCommandLinkButton控件的使用

QCommandLinkButton可以通过以下代码创建：

button = QtWidgets.QCommandLinkButton("Button Text", self)

其中，“Button Text”是按钮的文本信息，“self”是父对象。“button”是创建的QCommandLinkButton控件实例。

1. 添加按钮点击事件

在PyQt5中，按钮控件的常用事件是“clicked”事件。通过重写该事件来添加按钮的点击事件处理逻辑。

button.clicked.connect(self.onButtonClicked)

其中，“self.onButtonClicked”是按钮的点击事件处理函数。

def onButtonClicked(self):
    print("Button Clicked!")

2. 设置按钮的图标

QCommandLinkButton可以通过设置图标来美化按钮界面。图标可以通过以下代码设置：

icon = QtGui.QIcon("icon.png")
button.setIcon(icon)

其中，“icon.png”是图标的路径，可以是绝对路径或相对路径。

3. 设置显示的文本信息

QCommandLinkButton可以通过以下代码设置文本信息：

button.setText("Button Text")

其中，“Button Text”是要显示的文本信息。

切换可检查按钮的实现

QCommandLinkButton提供了一种称为“切换可检查按钮”的功能，即每次点击按钮时，按钮状态会切换为选中或未选中状态。可以通过以下代码来实现：

button.setCheckable(True)

确定按钮是否被选中可以通过QAbstractButton.isChecked()函数来实现：

isChecked = button.isChecked()

以下是一个完整的切换可检查按钮的示例代码：

from PyQt5 import QtWidgets, QtGui

class App(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        button = QtWidgets.QCommandLinkButton("Button Text", self)
        button.setCheckable(True)
        button.clicked.connect(self.onButtonClicked)

        vbox = QtWidgets.QVBoxLayout()
        vbox.addWidget(button)
        self.setLayout(vbox)

        self.show()

    def onButtonClicked(self):
        print("Button Clicked!")
        isChecked = self.sender().isChecked()
        print("Is Checked: ", isChecked)

if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    ex = App()
    sys.exit(app.exec_())

在该示例中，我们创建了一个切换可检查按钮的实例，每次点击按钮时，控制台会输出“Button Clicked!”以及按钮是否被选中的信息。

另外一个示例是实现一个可以选择多个选项的音乐播放器的功能。可以通过QCommandLinkButton的切换可检查按钮来实现。代码如下：

import random
from PyQt5 import QtWidgets, QtGui

class App(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()

        self.playList = [
            "Song 1",
            "Song 2",
            "Song 3",
            "Song 4",
            "Song 5",
            "Song 6",
        ]

        self.initUI()

    def initUI(self):
        vbox = QtWidgets.QVBoxLayout()
        for song in self.playList:
            button = QtWidgets.QCommandLinkButton(song, self)
            button.setCheckable(True)
            button.clicked.connect(self.onButtonClicked)
            vbox.addWidget(button)

        self.setLayout(vbox)
        self.show()

    def onButtonClicked(self):
        selectedSongs = []
        for button in self.findChildren(QtWidgets.QCommandLinkButton):
            if button.isChecked():
                selectedSongs.append(button.text())

        print("Selected Song(s): ", selectedSongs)

if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    ex = App()
    sys.exit(app.exec_())

在该示例中，我们创建了一个音乐播放器，用户可以通过勾选QCommandLinkButton控件来选择播放的歌曲。每次点击QCommandLinkButton控件时，控制台会输出用户已经选择的歌曲列表。