Qt Theme

Qt theme in pure qss - 纯 qss 的 Qt 主题

Preview and Export Resource Package Online - 在线预览和导出资源包

Preview - 预览

Usage - 使用说明

QtTheme is a pure QSS project, no language restrictions, use C++ description here.

1. Export the resource package from here, and add it to your project.

2. Use QMainWindow::setStyleSheet to set the global style.

   QFile file(":/QtTheme/theme/Flat/Dark/Blue/Pink.qss");
   file.open(QFile::ReadOnly);
   setStyleSheet(file.readAll());
   

3. Use QWdiget::setProperty to set the color.

   auto button = new QPushButton(tr("Button"));
   button->setProperty("Color", "Primary");
   

| Color | Explain | | :----------- | :------------------------------------------------------------------------- | | Primary | The primary color selected when exporting | | Secondary | The secondary color selected when exporting | | Success | The success color() | | Warning | The warning color() | | Danger | The error color() |

---

QtTheme 是纯 QSS 的项目，不受语言限制，这里使用 C++ 描述。

1. 在这里导出资源包，然后将其加入你的项目。

2. 使用 QMainWindow::setStyleSheet 设置全局样式。

   QFile file(":/QtTheme/theme/Flat/Dark/Blue/Pink.qss");
   file.open(QFile::ReadOnly);
   setStyleSheet(file.readAll());
   

3. 使用 QWdiget::setProperty 设置颜色。

   auto button = new QPushButton(tr("Button"));
   button->setProperty("Color", "Primary");
   

| 颜色 | 说明 | | :----------- | :---------------------------------------------------------- | | Primary | 导出时选择的主要颜色 | | Secondary | 导出时选择的次要颜色 | | Success | 成功色() | | Warning | 警告色() | | Danger | 危险色() |

Notice - 注意事项

Customized QWidget subclasses must override paintEvent, otherwise the style will not take effect on this class:

自定义的 QWidget 子类，必须重载 paintEvent，否则样式不会再该类上生效:

https://doc.qt.io/qt-6/stylesheet-reference.html#qwidget-widget

void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

Style will not update itself automatically when the value of a property referenced from the style sheet changes, you must update it manually:

当样式表引用的属性值发生变化时，样式不会自动更新，必须手动更新:

https://wiki.qt.io/Dynamic_Properties_and_Stylesheets

// property changes
widget->setProperty("Color", "Secondary");

// update style manually
widget->style()->unpolish(widget);
widget->style()->polish(widget);

QComboBox must set the view for the internal style to take effect:

QComboBox 必须设置 view, 内部的样式才能生效:

https://doc.qt.io/qt-6/stylesheet-reference.html#qcombobox-widget

comboBox->setView(new QListView);

Python

Install - 安装:

pip install QtTheme

Usage - 使用:

See here - 看这里

This method will include all resources of QtTheme. It is recommended to export the resource package from here, and add it to your project by RCC (pyrcc5 or pyside6-rcc).

这种方式将会包含 QtTheme 的全部资源。 建议从 这里 导出资源包， 然后通过 RCC (pyrcc5 or pyside6-rcc) 将它加入你的项目。

Build - 构建

Dependencies - 依赖

• Deb & Qt5: qtbase5-dev, qttools5-dev
• Deb & Qt6: qt6-base-dev, qt6-tools-dev
• Rpm & Qt5: qt5-qtbase-devel, qt5-qttools-devel
• Rpm & Qt6: qt6-qtbase-devel, qt6-qttools-devel

git clone git@github.com:hubenchang0515/QtTheme.git
cd QtTheme
git submodule update --init
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release --parallel

License

• This Project - 这个项目: AGPL-3.0-or-later
• Exported Resource - 导出的资源: MIT

Contributors

Examples

| Windows Native | QtTheme Flat | | :-: | :-: | | | | | | |