PyQt5 如何为 Qt 控件设置暗黑主题

在本文中，我们将介绍如何在 PyQt5 中为 Qt 控件设置暗黑主题。

阅读更多：PyQt5 教程

什么是暗黑主题？

暗黑主题是一种在软件用户界面中使用深色背景和亮色文本的设计风格。暗黑主题可以给用户带来更加现代和高端的感觉，并且在一些环境中可以减轻眼睛疲劳。

安装 PyQt5

首先，我们需要安装 PyQt5 库。可以使用 pip 命令来安装：

pip install pyqt5

创建一个简单的窗口

在开始设置暗黑主题之前，我们先创建一个简单的窗口以展示效果。以下是一个基本的窗口示例：

import sys
from PyQt5.QtWidgets import QApplication, QWidget

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    window.setWindowTitle('PyQt5 Dark Theme')
    window.setGeometry(100, 100, 300, 200)
    window.show()
    sys.exit(app.exec_())

运行以上代码，将会显示一个标题为 “PyQt5 Dark Theme” 的空白窗口。

使用 QSS 设置暗黑主题

PyQt5 允许我们使用 QSS（Qt Style Sheets）来设置控件的样式。QSS 是一种灵活的机制，可以通过 CSS 类似的语法来控制控件的外观。

以下示例代码展示了如何使用 QSS 来设置暗黑主题：

import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtCore import QFile


if __name__ == '__main__':
    app = QApplication(sys.argv)

    # 创建一个窗口
    window = QWidget()
    window.setWindowTitle('PyQt5 Dark Theme')
    window.setGeometry(100, 100, 300, 200)

    # 使用 QSS 设置控件样式
    style_file = QFile("dark.qss")  # 加载 QSS 文件
    style_file.open(QFile.ReadOnly | QFile.Text)  # 打开文件
    style = str(style_file.readAll(), encoding='utf-8')  # 读取文件内容
    app.setStyleSheet(style)  # 设置 QSS 样式

    # 显示窗口
    window.show()
    sys.exit(app.exec_())

在上面的代码中，我们首先创建了一个名为 “dark.qss” 的文件来存储暗黑主题的样式。可以根据自己的需求来设计样式，下面是一个示例的 “dark.qss” 文件：

QWidget {
    background-color: #1E1E1E;  /* 设置窗口背景颜色 */
    color: #FFFFFF;  /* 设置文本颜色 */
}

QPushButton {
    background-color: #383838;  /* 设置按钮背景颜色 */
    color: #FFFFFF;  /* 设置按钮文本颜色 */
    border: 1px solid #FFFFFF;  /* 设置按钮边框样式 */
    padding: 5px;  /* 设置按钮的内边距 */
}

QLineEdit {
    background-color: #282828;  /* 设置文本输入框背景颜色 */
    color: #FFFFFF;  /* 设置文本输入框文本颜色 */
    border: 1px solid #FFFFFF;  /* 设置文本输入框边框样式 */
    padding: 5px;  /* 设置文本输入框的内边距 */
}

QLabel {
    color: #FFFFFF;  /* 设置标签文本颜色 */
}

保存上面的代码为 “dark.qss” 文件，并与主程序文件放在同一目录下。然后运行主程序，将会显示一个使用暗黑主题的窗口，其中包含了修改过的按钮、文本输入框和标签的样式。

自定义暗黑主题

通过修改 QSS 文件，我们可以根据自己的需求来自定义暗黑主题的样式。下面是一些常见的样式属性，可以根据需要进行调整：

background-color：控件的背景颜色
color：控件的文本颜色
border：控件的边框样式
padding：控件的内边距
font-size：控件的字体大小

例如，如果要修改按钮的圆角边框样式，可以使用以下代码：

QPushButton {
    background-color: #383838;
    color: #FFFFFF;
    border: 2px solid #FFFFFF;
    border-radius: 10px;  /* 设置圆角边框 */
    padding: 5px;
}

除了常规控件的样式外，还可以通过以下方式对特定控件进行自定义：

QSlider::groove:horizontal {
    background-color: #383838;
    height: 10px;
    border-radius: 5px;
}

QSlider::handle:horizontal {
    background-color: #FFFFFF;
    border: 1px solid #FFFFFF;
    width: 20px;
    height: 20px;
    margin: -5px 0;
    border-radius: 10px;
}

通过上述代码，可以设置水平滑块的样式，包括滑道（groove）和滑块（handle）。