中文 EN

快速接入

快速接入

本章说明如何在 Qt Widgets 项目中加载 StyleKit 样式。

基础流程

  1. 将 QSS 文件复制到项目资源目录。
  2. 在应用启动时读取 QSS 内容。
  3. 调用 qApp->setStyleSheet(...) 应用样式。
  4. 根据文档设置控件对象名或属性。

C++ 示例

QFile file(":/themes/stylekit-light.qss");
if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    qApp->setStyleSheet(QString::fromUtf8(file.readAll()));
}

常用调用方法

方法 说明 参数 返回值
QFile file(path) 创建 QSS 文件读取对象。 path：QSS 资源路径或本地文件路径。 QFile 对象
file.open(QIODevice::ReadOnly | QIODevice::Text) 以只读文本方式打开 QSS 文件。 打开模式组合。 bool，打开是否成功
file.readAll() 读取完整 QSS 内容。 无 QByteArray
QString::fromUtf8(data) 将 UTF-8 字节内容转换为 QString。 data：QSS 字节内容。 QString
qApp->setStyleSheet(qss) 将 QSS 应用到整个 Qt 应用。 qss：样式表字符串。 void

注意事项

  • 建议在应用初始化阶段统一加载。
  • 不建议在多个页面重复覆盖全局样式。
  • 特殊控件可通过对象名做局部定制。